BOSH Backup and Restore

BOSH Backup and Restore is a CLI utility for orchestrating the backup and restore of BOSH deployments and BOSH directors. It orchestrates triggering the backup or restore process on the deployment or director, and transfers the backup artifact to and from the deployment or director.

This repository contains the source code for BOSH Backup and Restore.

Install

The latest BBR binaries for Linux and macOS are available to download on the releases page.

On macOS, you can install BBR using Homebrew:

1. brew tap cloudfoundry/tap
2. brew install bbr

CI Status

BOSH Backup and Restore build status

Developing BBR locally

We use dep to manage our dependencies, so run:

1. git clone git@github.com:cloudfoundry-incubator/bosh-backup-and-restore.git $GOPATH/src/github.com/cloudfoundry-incubator/bosh-backup-and-restore
2. cd $GOPATH/src/github.com/cloudfoundry-incubator/bosh-backup-and-restore
3. go get -u github.com/cloudfoundry/bosh-cli
4. go get -u github.com/maxbrunsfeld/counterfeiter
5. go get -u github.com/onsi/ginkgo/ginkgo
6. make setup

You're good to go. Run tests locally with make test.

Additional information

Docs: http://docs.cloudfoundry.org/bbr/index.html

Slack: #bbr on https://slack.cloudfoundry.org

Talks:

• Burning Down the House: How to Plan for and Deal with Disaster Recovery in CF at Cloud Foundry Summit Europe 2017
• Extending the BOSH Backup and Restore Framework at Cloud Foundry Summit 2018
• Reviving the platform every day at Cloud Foundry Summit EU 2018

Blog posts:

• Cloud-Native Recovery Tool, BOSH Backup & Restore, Now Available in Public Beta on the Pivotal Blog
• TUTORIAL: Automating ERT Backups with BBR and Concourse