prerequisites.md

Prerequisites

Follow this guide to prepare you Google Cloud Project and deployment machine.

Setting up your Google Cloud Project

1. Sign up for Google Cloud Platform
2. Create a new project
3. Enable the Cloud Resource Manager API
4. Enable billing
5. Verify your existing quota and file a quota increase of necessary.
   • If deploying Small Footprint Runtime (default):
     • Persistent Disk Standard (GB) (in desired region): 10,000 GB
     • CPUs (in desired region): 24
   • If deploying Elastic Runtime:
     • Persistent Disk Standard (GB) (in desired region): 10,000 GB
     • CPUs (in desired region): 200

Setting up your Deployment Machine

Option 1: Using Cloud Shell

Cloud Shell already includes many of the dependencies and is an excellent way to get started.

1. Open the Google Cloud Console

2. Ensure your project is active (See the Project Info section)

3. Click on the >_ icon in the upper right corner

4. Paste the following snippet into the console to install terraform and the cf cli to your local user directory:

   mkdir -p bin
   cd bin
   curl -o /tmp/terraform.zip https://releases.hashicorp.com/terraform/0.11.1/terraform_0.11.1_linux_amd64.zip
   unzip /tmp/terraform.zip terraform
   curl -L -o /tmp/cf.tgz "https://cli.run.pivotal.io/stable?release=linux64-binary&source=github"
   tar zxf /tmp/cf.tgz cf
   export PATH=$PATH:~/bin
   cd
   

The machine that hosts your Cloud Shell session is ephemeral but your user directory will be restored for future sessions.

> With these prerequisites installed you can move on to Setting up DNS

Option 2: Running Locally

A Linux or Mac machine is required with the following dependencies installed:

• gcloud
• terraform (v0.11.1+)
• dig
  • Debian/Ubuntu: sudo apt-get install dnsutils
  • OSX: preinstalled
• go (v1.8+)
• cf
• git

> With these prerequisites installed you can move on to Setting up DNS