Skip to content
This repository has been archived by the owner on Mar 24, 2022. It is now read-only.

Latest commit

 

History

History
62 lines (46 loc) · 3.32 KB

prerequisites.md

File metadata and controls

62 lines (46 loc) · 3.32 KB
Raw

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 the Compute API
  5. Enable billing
  6. 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
  7. Verify OS Login is NOT enabled in your project's Compute Engine project wide metadata. The quickstart relies on SSH keys from instance metadata during the installation process, and enabling OS Login will disable SSH keys from instance metadata. Ensure the enable-oslogin key is either not set or set to FALSE in the Compute Engine project wide metadata. (Running the script ./util/disable-os-login.sh will do this for you)

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.12+)
  • cf
  • git

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