Skip to content

Restoring from a BBR Backup

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:

    1
    2
    3
    4
    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:

    1
    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:

1
unknown handle: UUID
Solution: Recreate the pipelines by running fly set-pipeline.