Document our Terraform setup

[yuvipanda]

Background

We use Terraform to setup our core cloud resources. Currently, this is our Kubernetes Cluster, node pools and service account key. There is no documentation on this at all, and we should fix that. While there are fixes to be made to the terraform code itself, this goal should be just about documenting what we have.

Expected timeline

As a pure documentation goal, I expect this to take a week of writing here and there.

Steps to complete this goal

• Write a README listing the various components we setup via Terraform
• Document how to set up terraform locally
• Document where our terraform state is stored, and how to get access to it
• Document how we use workspaces, and what workspaces we have access to
• Document all terraform variables thoroughly
• Document how to change a nodepool in a cluster
• Document how to create a new cluster
• Document common pitfalls and how to watch out for them

[choldgraf]

We've got a lot of this documentation here now: https://infrastructure.2i2c.org/en/latest/topic/terraform.html

cc also @sgibson91 who noted that we should standardize our terraform config. Maybe whoever works on that can confirm and close this one as part of that effort

[yuvipanda]

I think we can open up more specific issues as they come, and going to close that now.