cf-blue-green-deploy

README

Blue/Green deployer plugin for CF

Introduction

cf-blue-green-deploy is a plugin for the CF command line tool that automates a few steps involved in zero-downtime deploys.

Overview

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

How to 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.

How to build

script/build

This will download dependencies, run the tests, and build binaries in the artefacts folder.