bosh-bootloader

README

bosh-bootloader

---

This is a command line utility for standing up a CloudFoundry or Concourse installation on an IAAS. This CLI supports bootstrapping a CloudFoundry or Concourse installation on AWS and GCP. Azure support is in progress.

• CI
• Tracker

Guides

• AWS - Getting Started
• AWS - Deploying Concourse
• GCP - Deploying Concourse
• GCP - Deploying Cloud Foundry
• Advanced BOSH Configuration

Prerequisites

Install Dependencies

The following should be installed on your local machine

• bosh-cli
• terraform >= 0.10.0
• ruby

Install bosh-bootloader using a package manager

Mac OS X

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

IAAS Configuration

AWS

Create an IAM user.

GCP

Create a service account.

Usage

The bbl command can be invoked on the command line and will display its usage.

$ bbl
Usage:
  bbl [GLOBAL OPTIONS] COMMAND [OPTIONS]

Global Options:
  --help      [-h]       Prints usage
  --state-dir            Directory containing bbl-state.json
  --debug                Prints debugging output
  --version              Prints version

Commands:
  help                    Prints usage
  version                 Prints version
  up                      Deploys BOSH director on an IAAS
  destroy                 Tears down BOSH director infrastructure
  lbs                     Prints attached load balancer(s)
  create-lbs              Attaches load balancer(s)
  update-lbs              Updates load balancer(s)
  delete-lbs              Deletes attached load balancer(s)
  rotate                  Rotates SSH key for the jumpbox user
  bosh-deployment-vars    Prints required variables for BOSH deployment
  jumpbox-deployment-vars Prints required variables for jumpbox deployment
  cloud-config            Prints suggested cloud configuration for BOSH environment
  jumpbox-address         Prints BOSH jumpbox address
  director-address        Prints BOSH director address
  director-username       Prints BOSH director username
  director-password       Prints BOSH director password
  director-ca-cert        Prints BOSH director CA certificate
  env-id                  Prints environment ID
  latest-error            Prints the output from the latest call to terraform
  print-env               Prints BOSH friendly environment variables
  ssh-key                 Prints SSH private key

  Use "bbl [command] --help" for more information about a command.

Generic steps to a Cloud Foundry deployment

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

2. bbl up with IAAS credentials as flags or environment variables.

3. bbl create-lbs --type cf with a certificate and key as flags or environment variables. (Continue to provide the IAAS credentials from Step 1 as flags or environment variables.)

4. eval "$(bbl print-env)" to export environment variables for the bosh-cli and to create an SSH tunnel to the BOSH director for Step 5.

5. bosh deploy with a CF deployment manifest!

To tear down load balancers, run bbl delete-lbs.

To tear it all down, run bbl destroy.

Note: You must delete your BOSH deployments before running bbl destroy.