cloudfoundry/bosh-bootloader

Name: bosh-bootloader

Owner: Cloud Foundry

Description: Command line utility for standing up a BOSH director on an IAAS of your choice.

Created: 2016-01-25 19:32:15.0

Updated: 2018-05-23 21:04:23.0

Pushed: 2018-05-23 15:55:56.0

Homepage:

Size: 15279

Language: Go

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

bosh-bootloader

Also known as bbl (pronounced: “bubble”), bosh-bootloader is a command line utility for standing up BOSH on an IaaS. bbl currently supports AWS, GCP, Microsoft Azure, Openstack and vSphere.

Docs
Prerequisites
Install Dependencies

The following should be installed on your local machine

Install bosh-bootloader using a package manager

Mac OS X

ew tap cloudfoundry/tap
ew install bosh-cli
ew install bbl
Usage
IaaS-Specific Getting Started Guides
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.

Automating the automation tool

In order to use bbl in your concourse pipelines, the current supported way for cf-deployment is to use the cf-deployment-concourse-tasks.

There is a work-in-progress concourse resource for bbl: bbl-state-resource.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.