This topic describes how to restore your Concourse pipelines from a Bosh Backup and Restore (BBR) backup. Reasons to restore Concourse from a backup include:

• Something went wrong with your Concourse pipelines
• You want to validate that a backup works

Procedure

1. Run the bbr deployment restore command:

   bbr deployment \
   --deployment TARGET-CONCOURSE \
   restore \
   --artifact-path PATH-TO-BACKUP
   

   Where:

   • TARGET-CONCOURSE is your target deployment, and
   • PATH-TO-BACKUP is the path to the backup directory you wish to restore from.

2. Make sure that you are running the same version of Concourse that your backup was created from.

3. Run the following command to verify that the state of your pipelines has been restored:

   fly -t TARGET-CONCOURSE pipelines
   

   Where TARGET-CONCOURSE is your target deployment.

Troubleshooting

Broken git Resources

Symptom: After a restore, git repository resources appear broken with an error like this:

unknown handle: UUID

Solution: Recreate the pipelines by running fly set-pipeline.