Map a Terraform root for an AWS or Google Cloud connection

Choose the registered GitHub repository and root that should own the proposed connection files. Check the existing declarations before asking Proofline to prepare a change.

Select the root and scope the variables#

  1. Open Settings → Connections → Terraform changes.
  2. Start a new Terraform change.
  3. Select the repository and its Terraform root. The list leaves out directories that another Terraform directory uses as a local module. To use one of them as a root, choose Enter a root path.
  4. Choose the cloud provider and provider name or alias.
  5. Select the connections owned by that root.
  6. For an AWS connection, choose the Terraform change: Add a Proofline IAM role, Set the variable of an existing role when the root already declares one, or Maintain the inventory grant on an existing role.
  7. To set a variable, enter the variables file in the root, such as terraform.tfvars, and the variable name.
  8. To maintain the inventory grant, choose Add a policy or Update a Terraform policy under Inventory policy. To update one, enter its Policy file and Policy resource label. List every region the connection reads in Inventory regions.
  9. Save the entry and inspect the generated change.

Prepare a Terraform pull request on a GKE cluster's setup opens a new change with that cluster and its namespaces selected.

Organization administrators and people with the Prepare Terraform changes permission can prepare a change. You need read access on GitHub to every repository you select. Preparing a change writes nothing to GitHub.

Connect the relevant AWS or Google Cloud account first. An AWS connection can be chosen once its setup confirms the account. When no AWS connection can be chosen yet, New change links to the unconfirmed connection's setup. Choose the root that actually owns the connection's infrastructure.

To set a variable, the root must declare it and the file must not set it yet. Proofline appends the connection's values and keeps the rest of the file unchanged.

The inventory grant lets Proofline read the account's inventory in the listed regions without taking ownership of the role. If the inventory policy already exists, choose Update a Terraform policy to edit the resource that owns it, or import it through your pipeline first.

Search help

Tab to a result. Enter to open. Escape to close.