bosh-bootloader

README

bosh-bootloader

Also known as bbl (pronounced: "bubble"), bosh-bootloader is a command line utility for standing up a CloudFoundry or Concourse installation on an IaaS. bbl currently supports AWS, GCP and Azure. Openstack and vSphere support are planned.

• CI
• Tracker

Guides

• AWS - Getting Started
• Deploying Concourse
• Advanced BOSH Configuration

Prerequisites

Install Dependencies

The following should be installed on your local machine

• bosh-cli
• bosh create-env dependencies
• terraform >= 0.11.0
• ruby (necessary for bosh create-env)

Install bosh-bootloader using a package manager

Mac OS X

$ brew tap cloudfoundry/tap
$ brew install bosh-cli
$ brew install bbl

Usage

Generic getting started guide

1. Create the necessary IaaS user/account for bbl.

2. bbl up --iaas <MY IaaS> with IaaS credentials as flags or environment variables.

3. eval "$(bbl print-env)" to target the director that you just created.

4. bosh ssh, bosh deploy or bosh env should all just work with no further information needed from bbl.

For detailed, IaaS specific instructions see your preferred IaaS's getting started guide:

• Azure - Getting Started
• GCP - Getting Started
• AWS - Getting Started

Generic steps for Cloud Foundry deployment

1. Create an environment and target the BOSH director as described above

2. bbl plan --lb-type cf --lb-cert cert --lb-key key && bbl up with a certificate and key as flags or environment variables. (Continue to provide the IaaS credentials as flags or environment variables.)

3. bosh deploy cf-deployment.yml -o operations/<MY IaaS> using the CF deployment manifest!

Managing state

The bbl state directory contains all of the files that were used to create your bosh director. This should be checked in to version control, so that you have all the information necessary to later destroy or update this environment at a later date.

filename	contents
bbl-state.json	Environment name, and bbl version metadata
bosh-deployment	The latest bosh-deployment that has been tested with your version of bbl
create-director.sh	The BOSH cli command bbl will use to create your director when you run bbl up. See docs/advanced-configuration for help with modifying this.
create-jumpbox.sh	The BOSH cli command bbl will use to create your jumpbox.
delete-director.sh	The BOSH cli command bbl will use to delete your director.
delete-jumpbox.sh	The BOSH cli command bbl will use to delete your jumpbox.
jumpbox-deployment	The latest jumpbox-deployment that has been tested with your version of bbl.
terraform	The terraform templates bbl used to pave your IaaS. See docs/advanced-configuration for information on modifying this.
vars	This is where bbl will store environment specific variables. Consider storing this outside of version control.

Tearing down an environment

Once you are done kicking the tires on CF and BOSH, clean up your environment to save IaaS costs:

1. You must first delete any deployments on BOSH. e.g. bosh -d cf delete-deployment

2. bbl down with your IaaS user/account information.