bosh-bootloader

module
v5.3.5+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 2, 2017 License: Apache-2.0

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.

Guides

Prerequisites

Install Dependencies

The following should be installed on your local machine

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.

Directories

Path Synopsis
aws
ec2
iam
iam/fakes
Code generated by counterfeiter.
Code generated by counterfeiter.
aws
gcp
aws
gcp

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL