convox/install/gcp/README.md
David Dollar cc55935f79
upload cli binaries during release (#53)
* upload cli binaries during release

* add install instructions

* update rack install instructions with new cli

* fix urls on links to install docs

* restructure cli installation docs

* rework installation text
2019-12-19 10:56:37 -05:00

1.1 KiB

Convox Rack on GCP

Initial Setup

  • Go to your GCP Dashboard
  • Create a new project
  • Note the ID of the project
  • Go to https://console.cloud.google.com/apis/credentials/serviceaccountkey
  • Ensure you have your new project selected from the dropdown
  • Select New Service Account
  • Give it a name like terraform
  • Give it the Project Owner role
  • Select key type JSON
  • Click Create
  • Download the credential file

Configuration

Environment Variables

  • GOOGLE_CREDENTIALS (path or contents of the credentials file)
  • GOOGLE_PROJECT (project id in which to install)
  • GOOGLE_REGION (required)

Install Convox

  • Clone this repository and switch to the directory containing this README
  • Run terraform init
  • Run terraform apply -target module.system.module.project to enable necessary services in your project
  • Run terraform apply

Convox CLI Setup

  • Install the Convox CLI
  • Run export RACK_URL=$(terraform output rack_url)
  • Run convox rack to ensure that your CLI is connected to your new Rack