Google Cloud

Please note that these are instructions for installing a Rack via the command line. The easiest way to install a Rack is with the Convox Web Console

Initial Setup

Google Cloud CLI

• Install the Google Cloud CLI
• Run gcloud init

Terraform

• Install Terraform

Convox CLI

• Install the Convox CLI

Environment

The following environment variables are required:

• GOOGLE_CREDENTIALS
• GOOGLE_PROJECT

Create Project

    $ gcloud projects create <id> --set-as-default

• GOOGLE_PROJECT is the id you selected

You will likely need to set up Billing on this new project at https://console.cloud.google.com/billing before proceeding You can find the full documentation on this here: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_an_existing_project

Create Service Account

    $ serviceaccount=$(gcloud iam service-accounts create convox --format="value(email)")
    $ gcloud iam service-accounts keys create ~/gcloud.convox --iam-account=${serviceaccount}

• GOOGLE_CREDENTIALS is ~/gcloud.convox

Grant Permissions

    $ gcloud projects add-iam-policy-binding $GOOGLE_PROJECT --member=serviceAccount:${serviceaccount} --role=roles/owner

Enable GCP APIs

    $ gcloud services enable compute.googleapis.com
    $ gcloud services enable cloudresourcemanager.googleapis.com

Install Rack

    $ convox rack install gcp <name> [param1=value1]...

Available Parameters