getting-started-gcp.md

Getting Started: GCP

This guide is a walkthrough for deploying a BOSH director with bbl on GCP. 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

Create a Service Account

In order for bbl to interact with GCP, a service account must be created.

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'

Pave Infrastructure, Create a Jumpbox, and Create a BOSH Director

1. Export environment variables.

   export BBL_IAAS=gcp
   export BBL_GCP_REGION=
   export BBL_GCP_SERVICE_ACCOUNT_KEY=
   

   or powershell:

   $env:BBL_IAAS="gcp"
   $env:BBL_GCP_REGION=
   $env:BBL_GCP_SERVICE_ACCOUNT_KEY=

2. Create an empty directory to use as your bbl state directory.

   mkdir some-bbl-state-dir
   cd some-bbl-state-dir
   

3. Create infrastructure, jumpbox, and bosh director.

   bbl up
   

Next Steps

• Target the BOSH Director
• Deploy Cloud Foundry
• Deploy Concourse