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, you must first log in to Apps Manager with an account that has adequate permissions. See the Understanding Permissions topic for more information.
On the space page, click the app you want to manage. You can search for the app by entering its name in the search bar.
From the app page, 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.
- To stop an app, click the stop button next to the name of the app. Click Stop in the pop-up to confirm.
- To restart a stopped app, click the play button next to the name of the app.
- To restart a running app, click the restart button next to the name of the app. Click Restart in the pop-up to confirm.
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.
- Under Scaling, adjust the number of Instances, the Memory Limit, and the Disk Limit as desired.
- Click Scale App.
- Click Services.
- To bind your app to a service, click Bind Service.
- To bind your app to an an existing service instance, perform the following steps:
- Click Bind Service.
- Under Service to Bind, select the service instance from the dropdown menu.
- Optionally add any parameters under Add Parameters.
- Click Bind.
- Click Bind Service.
- To bind your app to a new service instance, perform the following steps:
- Click New Service.
Note: If you prefer to create the new service instance in the Marketplace, you can click View in Marketplace at any time.
- Click the service.
- Select a plan and click Select Plan.
- Under Instance Name, enter a name for the instance.
- Optionally add any parameters under Add Parameters. The service may provide different parameter options, or a JSON editor for you to define the parameters. For more information, consult the documentation for the service.
- Click Create.
- Click New Service.
- 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.
- Click Routes.
- The page displays the routes associated with the app. To add a new route, click Map a Route.
- Enter the route and click Map.
- To unmap a route, locate the route from the list and click the red
x. Click Unmap in the pop-up to confirm.
- Click Logs to view the logs for the app.
- Click the play button to view a live version of the logs.
- Click the Tasks tab within Apps Manager.
- This page displays a table containing Task ID, State, Start Time, Task Name, and Command.
- Click Run Task to create a task.
- (Optional) Enter a Task Name.
- Enter the Task Command.
- Click Run.
Click the Settings tab. In this tab you can do the following:
- Rename the app.
- View information about the buildpack, start command, stack, and health check.
- View or add Environment Variables associated with the app.
- View the Application Security Groups (ASGs) associated with the app.
- Delete the app.
Follow the steps below to view information about a health check you have configured for your app. For more information, see the Using Application Health Checks topic.
- Click the Settings tab.
Under Info, find the Health check type. If your health check type is HTTP, Apps Manager also displays the Health check endpoint.
Follow the steps below to add a user-provided environment variable.
- Click the Settings tab.
- Click Reveal User Provided Env Vars.
- Enter the Name and Value of the variable.
- Click Save.
To view all environment variables, click Reveal Env Vars.
Note: Changes to environment variables, service bindings, and service unbindings require restarting the app to take effect. You can restart the app from the Apps Manager or with the Cloud Foundry Command Line Interface
cf restage command.
From the Services tab on the space page, you can bind or unbind apps, bind or unbind routes, view or change your service plan, manage service keys, and rename or delete your service instance.
For services that use on-demand brokers, the service broker will create, update, or delete the service instance in the background and notify you when it finishes.
From the space page Services tab, click the service instance you want to bind to an app.
Click Bind App. A popup appears.
In the Bind App popup, select the app you want to bind to your service instance.
(Optional) To attach parameters to the binding, click Show Advanced Options. Under Arbitrary Parameters, enter any additional service-specific configuration in the Name and Value fields.
From the space page Services tab, click the service instance you want to unbind from an app.
Locate the app under Bound Apps and click the red × on the right. An Unbind App popup appears.
Click Unbind to confirm.
From the space page Services tab, click the service instance you want to view or change the plan for.
Review your current plan information.
To change your plan, select a new plan from the list and click Select This Plan or Upgrade Your Account.
Note: Not all services support upgrading. If your service does not support upgrading, the service plan page only displays the selected plan.
From the space page Services tab, click the service instance you want to rename or delete.
To change the service instance name, enter the new name and click Update.
To add configuration parameters to the service instance, enter the parameters in the Name and Value fields, then click Update.
To delete the service instance, click Delete Service Instance.
Note: The service broker supports creating, updating, and deleting service instances asynchronously. When the service broker completes one of these operations, a status banner appears in Apps Manager.
Update Your User-Provided Service Instance
Follow the steps below to update an existing user-provided service instance. You can create a user-provided service instance from the Marketplace. For more information, see the User-Provided Service Instances topic.
- Click Configuration. This tab only appears for user-provided service instances.
- Enter your Credential Parameters, Syslog Drain Url, and Route Service Url, and click Update Service.
On the space page, click Services, then click the service instance that you want to manage service keys for. This directs you to the service instance Overview page, where you can generate a new service key, get the credentials for a service key, and delete a service key.
Follow the steps below to generate a service key.
In the Service Key Credentials section, click Create Service Key.
Edit the Service Key Name.
(Optional) Click Show Advanced Options. Under Arbitrary Parameters, enter any additional service-specific configuration in the Name and Value fields.
Click Create to generate the service key.
Follow the steps below to view the credentials for a service key.
To view the credentials for a particular service instance, click the service instance name under Service Key Credentials. The JSON object containing the credentials appears.
To delete a service key, click the red
x next to the service instance name.
For more information about route services, see the Route Services topic.
Follow the steps below to bind a new service instance to a route.
- Select the service from the Marketplace.
- Under Bind to Route, either bind the service instance to an existing
route or click Create Route to create a new custom route.
Note: You must choose a Marketplace service compatible with route services for the Bind to Route field to appear.
- Complete the remaining fields and click Add to create the service instance.
Follow the steps below to bind an existing service instance to a route.
- On the space page, click Services.
- Click the service instance that you want to manage route services for.
Note: If the service is not compatible with route services, the text “This service does not support route binding” appears under Bound Routes.
- To bind the service instance to a route, click Bind Route.
- Select an existing route under Select a route to bind or enter a new route under Create Custom Route.
- Click Bind.
To unbind a route from a service instance, click the red
x next to the name
of the route under Bound Routes.