Getting Started: OpenStack

This guide is a walkthrough for deploying a BOSH director with bbl on OpenStack. Upon completion, you will have the following:

  1. A BOSH director
  2. A jumpbox
  3. A set of randomly generated BOSH director credentials
  4. A generated keypair allowing you to SSH into the BOSH director and any instances BOSH deploys
  5. A copy of the manifest the BOSH director was deployed with
  6. A basic cloud config

bbl creates and maintains the lifecycle of the OpenStack infrastructure, jumpbox and BOSH director.
It creates a network, a router, a floating IP, a key pair, security groups, and security group rules on OpenStack.
Prerequisite is that an OpenStack project, external network, and user already exist.

Create a Jumpbox and a BOSH Director

  1. Export environment variables. ``` export BBL_IAAS=openstack export BBL_OPENSTACK_AUTH_URL= export BBL_OPENSTACK_AZ= export BBL_OPENSTACK_NETWORK_ID= # external network ID export BBL_OPENSTACK_NETWORK_NAME= # external network name export BBL_OPENSTACK_PASSWORD= export BBL_OPENSTACK_USERNAME= export BBL_OPENSTACK_PROJECT= # same as tenant export BBL_OPENSTACK_DOMAIN= export BBL_OPENSTACK_REGION=

    optionally

    export BBL_OPENSTACK_CACERT_FILE= # custom CA certificate when communicating over SSL; either path to file or contents of certificate

    export BBL_OPENSTACK_INSECURE= # e.g. "true", default: "false"

    export BBL_OPENSTACK_DNS_NAME_SERVERS= # e.g. "8.8.8.8,9.9.9.9", default: "8.8.8.8"

    ```

  2. Create OpenStack resources, jumpbox and bosh director. bbl up

Next Steps