Using the Stack Auditor Plugin
This topic describes how to use the Stack Auditor plugin for the Cloud Foundry Command Line Interface (cf CLI).
Stack Auditor is a cf CLI plugin that provides commands for listing apps and their stacks, migrating apps to a new stack, and deleting a stack.
One use case for Stack Auditor is when you must migrate a large number of apps to a new stack. This includes moving from
cflinuxfs3 in preparation to upgrade your deployment to a version that does not contain
cflinuxfs3. The following table describes the workflow you can use:
|1||Operator audits stack usage to determine which apps need to be migrated. See List Apps and Their Stacks.|
|2||Operator communicates with developers that they must migrate their existing apps to a new stack and begin pushing all new apps to the a new stack.|
|3||Developers migrate their apps to a new stack. See Change Stacks.|
|4||Operator confirms apps have been migrated and deletes the stack. See Delete a Stack.
Note: If you upgrade your deployment to a version that contains the stack you deleted, the stack returns on upgrade.
|5||If applicable, operator upgrades the deployment to the version that does not contain the old stack.|
To install Stack Auditor, do the following:
Clone the repository to your workspace:
git clone https://github.com/cloudfoundry/stack-auditor.git
Change directories to the repo you cloned:
Run the install script:
The sections below describe how to use Stack Auditor.
This section describes how to see the apps in each org and space and what stack they are using.
To see which apps are using which stack, run the following command:
This section describes how to change the stack that an app uses. Stack Auditor restages the app onto the new stack without a change in the source code of the app. If you want to move the app to a new stack with updated source code, follow the procedure in the Changing Stacks topic.
WARNING: Stack Auditor restages the app, which causes downtime. To avoid downtime, use a blue-green deployment strategy. See Using Blue-Green Deployment to Reduce Downtime and Risk.
To change the stack an app uses, do the following:
Target the org and space of the app:
cf target ORG SPACE
ORGis the org the app is in
SPACEis the space the app is in
Run the following command:
Note: If the app is in a
stoppedstate, it remains stopped after changing stacks.
cf change-stack APP-NAME STACK-NAME
APP-NAMEis the app that you want to move to a new stack
STACK-NAMEis the stack you want to move the app to
This section describes how to delete a stack from your deployment. You must be an admin user to complete this step.
To delete a stack, run the following command:
cf delete-stack STACK-NAME
STACK-NAMEis the name of the stack you want to delete.