Other providers

Terrateam can be used with various cloud providers beyond AWS, GCP, and Azure. To integrate Terrateam with other providers, you need to configure authentication and authorization based on the specific provider’s requirements.

Overview

Terrateam needs permission to access resources in your cloud provider, regardless of which provider you’re using. Without proper credentials, Terrateam won’t have permission to view or update cloud resources using the Terraform CLI. Most cloud providers have an official Terraform provider listed on the Terraform Registry. The authentication process may vary between providers, so it’s essential to refer to the official documentation of the Terraform provider you’re using for specific setup instructions. In general, most Terraform providers require a secret access token for authentication, which can be provided through an environment variable.

Typical setup steps

While the exact steps may vary depending on the provider, the typical setup process for integrating Terrateam with other cloud providers is as follows:

Create a user, role, or service account on your cloud provider with the appropriate access permissions for Terrateam.
Generate a secret access token for the newly created user, role, or service account.
Create the required environment variables for the provider to consume using GitHub Secrets.

Example: Fly.io

Let’s take a look at an example of configuring Terrateam with the Fly.io Terraform provider.

Provider configuration

The Fly.io Terraform provider can be configured with the following Terraform code:

provider "fly" {
  # Please don't do this. Use the FLY_API_TOKEN env variable instead.
  flytoken = "abc123"
}

As you can see, the fly provider requires a token. This can be specified by using a flytoken configuration inside the provider block or by setting a FLY_API_TOKEN environment variable. It’s recommended to use an environment variable to store the token securely, as storing secrets and passwords directly in Git is not a good practice.

Prerequisites

Before you begin, ensure you have the following:

GitHub CLI

Setup steps

Export your Terraform organization/repo combination as an environment variable. For example:
```
export REPO="<OWNER/REPO>"
```
Choose a Fly.io user you wish to use with Terrateam.
Create a new Fly.io customer access token:
```
export FLY_API_TOKEN=$(fly auth token)
```

Create the FLY_API_TOKEN GitHub Secret:

gh secret --repo "$REPO" set FLY_API_TOKEN --body "$FLY_API_TOKEN"

The next time you issue a Terrateam operation, the Terrateam GitHub Action runner will pull down the FLY_API_TOKEN GitHub Secret to be used against Fly.io resources.