Skip to content

cost_estimation

The cost_estimation configuration can automatically provide cost estimates on each pull request that Terrateam runs a plan operation against. A comment will be placed alongside plan output showing the monthly spend change for the dirspace.

Default Configuration

cost_estimation:
enabled: true
provider: infracost
currency: USD

Keys

KeyTypeDescription
enabledbooleanSpecifies whether cost estimation is enabled. Default is true.
providerstringSpecifies the provider for cost estimation. Default is infracost.
currencystringSpecifies the currency for cost estimation. Default is USD.

Providers

Infracost

API Key

If an Infracost API key is configured as a GitHub Actions Secret, then Terrateam will use the official Infracost public API endpoint. To set your Infracost API Key as a GitHub Actions Secret:

  1. Export your Terraform organization/repo combination as an environment variable. For example:
export REPO="OWNER/REPO"
  1. Create the Infracost API Key GitHub Secret:
gh secret --repo "$REPO" set INFRACOST_API_KEY

Environment Variables

Terrateam supports the following Infracost environment variables:

NameDescription
INFRACOST_API_KEYUser’s Infracost API key. Sign up and navigate to the Org Settings page to get your free Infracost API key.
INFRACOST_CURRENCYAn ISO 4217 currency code to report results. The value in the repository configuration takes precedence.

Examples

Enable Cost Estimation with Default Settings

cost_estimation:
enabled: true

This configuration will enable cost estimation using the default provider (Infracost) and currency (USD).

Disable Cost Estimation

cost_estimation:
enabled: false

This configuration will disable cost estimation.

Specify a Different Currency

cost_estimation:
enabled: true
currency: EUR

This configuration will enable cost estimation and report results in Euros (EUR).