Skip to content

cloudfoundry/bosh-backup-and-restore

Repository files navigation

BBR Build Status Badge

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

Developing BBR locally

We use go modules to manage our dependencies, so run:

  1. git clone git@github.com:cloudfoundry-incubator/bosh-backup-and-restore.
  2. go mod download

Unit tests make use of Docker containers to test networking. Ensure that Docker is running in your environment, before attempting to run tests. These can be run with the command: make test.

Note: if you see timeout errors occurring in the SSH suite of unit tests this may be due to the number of nodes the tests are running on. You can run ginkgo -nodes=<number> -r to reduce the number of nodes and decrease the concurrent requests being made to the Docker Daemon which will slow when under load.

Additional information

Slack: #bbr channel on https://slack.cloudfoundry.org (link here)

Talks:

Blog posts: