GOV.UK application deployment scripts

This repository contains Capistrano deployment scripts for applications running on GOV.UK.

We're in the process of moving our deployment code from a private repo to this one.

Adding a new app

See the documentation in the opsmanual.

How deployments work

The jenkins.sh script in this repo is run from the Jenkins job to deploy our applications.

The files in alphagov-deployment for each application are copied to a secrets directory during the deploy so that they are available to the Capistrano deploy scripts. (This is a deprecated mechanism for setting environment-specific configuration and should not be used for new configuration - use environment variables instead.)

Deployments to all environments use the master branches of this repository and of alphagov-deployment.

Environment variables available to deploy scripts

There are a number of environment variables set in Jenkins that can be used in deploy scripts:

• DEPLOY_TO - the environment being deployed to
• DEPLOY_TASK - the deploy task selected in the Jenkins interface ("deploy", "deploy:setup", etc)
• TAG - the tag/branch entered in the Jenkins interface ("release", "release_1234", "build-1234", etc)
• ORGANISATION - The vCloud organisation being deployed to
• CI_DEPLOY_JENKINS_API_KEY - API key used to fetch build artefacts from ci.dev.publishing.service.gov.uk.