cf-blue-green-deploy is a plugin for the CF command line tool that automates a few steps involved in zero-downtime deploys.
The plugin takes care of the following steps packaged into one command:
- Pushes the current version of the app with a new name
- Optionally runs smoke tests against the newly pushed app to verify the deployment
- If smoke tests fail, newly pushed app gets marked as failed and left around for investigation
- If smoke tests pass, remaps routes from the currently live app to the newly deployed app
- Cleans up versions of the app no longer in use
- Get the plugin from the CF Community Repository
cf install-plugin blue-green-deploy -r CF-Community
- Deploy your app
cd your_app_root
cf blue-green-deploy app_name
- Deploy with optional smoke tests
cf blue-green-deploy app_name --smoke-test <path to test script>
- You can also use the shorter alias
cf bgd app_name
The only argument passed to the smoke test script is the FQDN of the newly pushed app. If the smoke test returns with a non-zero exit code the deploy process will stop and fail, the current live app will not be affected.
If the test script exits with a zero exit code, the plugin will remap all routes from the current live app to the new app. The plugin supports routes under custom domains.
script/build
This will download dependencies, run the tests, and build binaries in the artefacts folder.