Skip to content

Latest commit

 

History

History
 
 

infra

README.md

Cloud Infrastructure

The Google Cloud Platform (GCP) and Cloudflare infrastructure resources required by the app and that can be bootstrapped via Terraform.

Requirements

How to install Terraform CLI on macOS?
$ brew tap hashicorp/tap
$ brew install hashicorp/tap/terraform
$ brew update
$ brew upgrade hashicorp/tap/terraform
$ yarn tf -version
How to create Google Cloud Platform projects?

Simply navigate to Google Cloud Resource Manager and create two GCP projects for both test (QA) and prod (production) environments, e.g. "example" and "example-test".

Fore more information visit https://cloud.google.com/resource-manager/docs/creating-managing-projects

How to configure Terraform Cloud workspaces?
  1. Sign in to Terraform Cloud dashboard.
  2. Create or join an organization.
  3. Create two workspaces — app-test and app-prod for test/QA and production environments.
  4. In each of these workspaces create an environment variable called GOOGLE_CREDENTIALS with the value containing JSON key of a GCP service account. Note, this GCP service account needs to have Owner or Editor + Service Usage Admin roles.

For more information visit https://registry.terraform.io/providers/hashicorp/google/latest/docs/guides/provider_reference

How to authenticate Terraform CLI in Terraform Cloud?
  1. Create a personal or team API Token via Terraform Cloud dashboard → Settings.
  2. Save API token to the .terraformrc file in root of the project:
credentials "app.terraform.io" {
  token = "xxxxxx.atlasv1.zzzzzzzzzzzzz"
}

NOTE: This would allow to using different Terraform credentials per software project if you want to.

Getting Started

  • yarn tf init -upgrade — Initializes a Terraform workspace
  • yarn tf plan — creates an execution plan
  • yarn tf apply — executes the actions proposed by the yarn tf plan command

NOTE: By default the app-test Terraform workspace is used. In order to use the production workspace, set TF_WORKSPACE environment variable to prod. For example:

$ TF_WORKSPACE=prod tf plan
$ TF_WORKSPACE=prod tf apply

NOTE: You need to run Terraform commands via yarn tf <command> [...args].

Fore more information visit https://learn.hashicorp.com/terraform