HashiCorp Cloud Platform (formerly Terraform Cloud)
Setting up Terraform Cloud VCS Integration
Last updated
Setting up Terraform Cloud VCS Integration
Last updated
Terraform Cloud allows you to manage Terraform runs in a consistent and reliable environment instead of on your local machine.
Resourcely leverages Terraform Cloud in order to:
Use Terraform in a consistent and reliable environment
Easily access shared state and secret data
Run Terraform within a repository using CI/CD
If you don't currently have a Terraform Cloud account, you can set one up using the following tutorial:
Once you have access to Terraform Cloud you must configure as stated below.
Once you have a Terraform Cloud account you must configure it for use with Resourcely by performing the following:
Adding External Cloud Provider Credentials
Creating a new Workspace
Generating a Team Token
In order to provision resources using Resourcely, you must have permission to actually generate cloud resources using Terraform. This requires access to a cloud provider such as Amazon Web Services (AWS), Google Cloud Platform (GCP), or Microsoft Azure.
You can create a credential variable set by going through the following guide:
Workspaces determine how Terraform Cloud organizes infrastructure. A workspace contains your Terraform configuration (infrastructure as code), shared variable values, your current and historical Terraform state, and run logs.
You must create a Version control workflow that stores your Terraform configuration in your git repos and triggers run based on pull requests and merges. See the following documentation to learn more:
Adding the Version control workflow will enable Terraform plans to run whenever a code change is made within a branch. Resourcely will use that plan in order to validate guardrails before the infrastructure can be provisioned.
Team API tokens are used by services, for example, a CI/CD pipeline, to perform plans and apply them on a workspace. Resourcely uses the token in order to verify the Terraform plan.
See the following documentation to learn how to generate a Team API Token:
An organization token is not valid and cannot be used to access a terraform plan which will cause a plan detection error when using the Resourcely CI/CD Job.
Be sure to save your token in a safe place, you will need to refer to it when setting up the Resourcely CI/CD job.
