Terraform

Terraform is an infrastructure as code tool that lets you build, change, and version infrastructure safely and efficiently. This guide explains how to add Terraform integration to Cloudaware.

To see how Cloudaware seamlessly integrates with Terraform in action, request a demo.

Prerequisites

1. Create a Terraform API token. Read more

2. Ensure the token has Viewer permissions for all Projects and Workspaces. Read more

3. For self-hosted Terraform, ensure the instance URL is publicly accessible.

Add Terraform credentials

1. Log in to Cloudaware → Admin.
   

   

2. Find Terraform in DevOps integrations. Click +ADD.
   

   

3. Fill out the form:
   

   

   WHERE
   Token Name – a name for the Terraform integration
   Terraform Token – the Terraform API token. To locate the token, go to Terraform Cloud dashboard -> Settings → Personal API Tokens. Cloudaware supports User, Team, and Organization API tokens.
   URL – for self-hosted Terraform, enter the URL in the format https://terraform.companyname.com/; for the cloud-hosted version, leave this field empty, Cloudaware will use https://app.terraform.io as the default endpoint
   Trust Certificate – check this box for self-hosted Terraform only
   
   Click SAVE.
   

4. Open the tab ’Terraform Organizations' to view the added organization(s). A green light in the ‘Status’ column indicates successful configuration. If the light is red, contact support@cloudaware.com.
   

   

5. To view Terraform-related data, go to Cloudaware CMDB Navigator. Select HCP TERRAFORM in the left-hand menu.
   

   

List of Terraform objects

Cloudaware supports the following Terraform objects:

• Terraform Cloud Resource AWS CA10TF__CaTerraformCloudResourceAws__c

• Terraform Organization CA10TF__CaTerraformOrganization__c

• Terraform Organization Member CA10TF__CaTerraformOrganizationMember__c

• Terraform Project CA10TF__CaTerraformProject__c

• Terraform Registry Module CA10TF__CaTerraformRegistryModule__c

• Terraform Registry Provider CA10TF__CaTerraformRegistryProvider__c

• Terraform Run CA10TF__CaTerraformRun__c

• Terraform Team CA10TF__CaTerraformTeam__c

• Terraform Team User Link CA10TF__CaTerraformTeamUserLink__c

• Terraform User CA10TF__CaTerraformUser__c

• Terraform Workplace CA10TF__CaTerraformWorkspace__c