bosh-bootloader

module
v4.4.0+incompatible Latest Latest
Warning

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

Go to latest
Published: Aug 30, 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 bosh-bootloader using a package manager

Mac OS X (using Homebrew via the cloudfoundry tap):

$ brew install cloudfoundry/tap/bbl
Install Dependencies

The following should be installed on your local machine

  • BOSH v2 CLI BOSH v2 CLI. This can be installed through homebrew.
$ brew install cloudfoundry/tap/bosh-cli --without-bosh2
Install bosh-bootloader

bbl can be installed by downloading the latest Github release:

Configure AWS

The AWS IAM user that is provided to bbl will need the following policy:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ec2:*",
                "cloudformation:*",
                "elasticloadbalancing:*",
                "route53:*",
                "iam:*",
                "logs:*",
                "kms:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
Configure GCP

To allow bbl to set up infrastructure a service account must be provided with the role 'roles/editor'

Example:

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:
  bosh-deployment-vars   Prints required variables for BOSH deployment
  cloud-config           Prints suggested cloud configuration for BOSH environment
  create-lbs             Attaches load balancer(s)
  delete-lbs             Deletes attached load balancer(s)
  destroy                Tears down BOSH director infrastructure
  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
  help                   Prints usage
  lbs                    Prints attached load balancer(s)
  ssh-key                Prints SSH private key
  up                     Deploys BOSH director on an IAAS
  update-lbs             Updates load balancer(s)
  version                Prints version

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

Directories

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

Jump to

Keyboard shortcuts

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