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 that 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 – enter a name for the integration
   Terraform Token – enter a 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 the field empty as Cloudaware will use https://app.terraform.io as the default endpoint
   Trust Certificate – check this box for self-hosted Terraform only
   
   Click SAVE.
   

4. Check the tab ’Terraform Organizations' to view the added organization(s). A green light in the ‘Status’ column indicates a 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 menu on the left:
   

   

List of Terraform objects

Cloudaware supports the following Terraform objects:

Terraform Organization
Terraform Project
Terraform Registry Module
Terraform Registry Provider
Terraform Team
Terraform Workplace