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.

gcloud iam service-accounts create <service account name>

gcloud iam service-accounts keys create --iam-account='<service account name>@<project id>.iam.gserviceaccount.com' <service account name>.key.json

gcloud projects add-iam-policy-binding <project id> --member='serviceAccount:<service account name>@<project id>.iam.gserviceaccount.com' --role='roles/editor'

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.