Pivotal Cloud Foundry v1.9

Managing Apps and Service Instances Using Apps Manager

Page last updated:

This topic discusses how to view and manage apps and service instances associated with a space using Apps Manager.

To perform the following steps, log in to Apps Manager with an account that has adequate permissions. See the Understanding Permissions topic for more information.

Manage an App

On the space page, click the app you want to manage. This directs you to the app page, where you can scale apps, bind apps to services, manage environment variables and routes, view logs and usage information, start and stop apps, and delete apps.

App page

Start or Stop an App

  1. To stop an app, click the stop button next to the name of the app. Click Stop in the pop-up to confirm.
  2. To restart a stopped app, click the play button next to the name of the app.
  3. To restart a running app, click the restart button next to the name of the app. Click Restart in the pop-up to confirm.

Scale an App

Note: You can configure your app to scale automatically based on rules that you set. See the Scaling an Application Using Autoscaler topic for more information.

  1. Under Scaling, adjust the number of Instances, the Memory Limit, and the Disk Limit as desired.
  2. Click Scale App.

Bind or Unbind a Service

  1. Click Services.
  2. To bind your app to a service, click Bind a Service. Bound services
  3. To bind your app to an an existing service instance, choose the service instance from the dropdown menu, and click Bind. To bind your app to a new service instance, click Go to the Marketplace to choose a service from the Marketplace.
  4. To unbind your app from a service instance, locate the service instance in the Bound Services list and click the three-dot icon on the far right. Select Unbind from the dropdown menu.

View or Add Environment Variables

  1. Click Env Variables. Env vars
  2. The page displays both the User Provided Environment Variables and System Provided Environment Variables environment variables associated with the app.
  3. To add a user-provided environment variable, enter the Name and Value and click Save.

Note: Changes to environment variables, as well as to service bindings and unbindings, require restarting the app to take effect. You can restart the app from the Apps Manager or with cf restage from the Cloud Foundry Command Line Interface (cf CLI).

Map or Unmap Routes

  1. Click Routes.
  2. The page displays the routes associated with the app. To add a new route, click Map a Route. Routes
  3. Enter the route and click Map.
  4. To unmap a route, locate the route from the list and click the red x. Click Unmap in the pop-up to confirm.

View Logs

  1. Click Logs to view the logs for the app. Logs
  2. Click the play button to view a live version of the logs.

View Settings

Click the Settings tab. In this tab you can do the following:

  • Rename the app.
  • Delete the app.
  • View the Application Security Groups (ASGs) associated with the app.

Manage a Service Instance

On the space page, click Services, then click the service instance you want to manage. This directs you to the service instance page, where you can bind or unbind apps, view or change your service plan, and rename or delete your service instance.

Bind or Unbind an App

Follow the steps below to bind or unbind an app.

Services binding

  1. Click Edit Bindings.

  2. Select the checkbox for the apps you want to bind to or unbind from your service instance.

  3. Click Save.

View or Change Your Service Plan

Follow the steps below to view or change your service plan.

  1. Click Plan.

    Services plan

  2. Review your current plan information.

  3. To change your plan, select a new plan from the list and click Select this plan.

Note: Not all services support upgrading. If your service does not support upgrading, the service plan page only displays the selected plan.

Rename or Delete Your Service Instance

  1. Click Settings.

    Services settings

  2. To change the service instance name, enter the new name and click Save changes.

  3. To delete the service instance, click Delete Service Instance.

Create a pull request or raise an issue on the source for this page in GitHub