Terraform
Configure a license
This topic describes how to configure the license so that you can deploy Terraform Enterprise to one of the supported runtimes environments. For information about configuring a Terraform Enterprise for the Replicated platform, refer to Deploy Terraform Enterprise to Replicated.
Acquiring a new Terraform Enterprise license
To acquire a new Terraform Enterprise license from HashiCorp, contact your account manager.
Apply the Terraform Enterprise license
There are two ways to apply the new license file on startup:
- Provide the body of the license file as a string to an environment variable called
TFE_LICENSE. - Store the license in a file and provide the file path to an environment variable called
TFE_LICENSE_PATH.
License expiration and termination
To prevent unexpected outages caused by delays in license updates, HashiCorp licenses provisioned for production use will not terminate on their expiry date.
If your license expires, you cannot use it for authentication with the HashiCorp image registry (images.registry.hashicorp.com). If you configure your installation to pull directly from the HashiCorp registry and your license expires, you cannot reinstall, scale, or upgrade. You can check your license expiration date using the tfectl app license command.
License updates
To update an existing installation with a new license, you will need to modify the TFE_LICENSE or TFE_LICENSE_PATH
variable and restart the application.
Product data collection reference
The following JSON payload describes the product usage data that Terraform Enterprise collects.
{
"version":"2",
"mode": "automatic",
"timestamp":"${TIME_OF_EXPORT}",
"signature": "${UUID}",
"checksum": "${UUID}",
"snapshots":[
{
"snapshot_version":2,
"id":"${SNAPSHOT_ID}",
"timestamp":"${TIME_OF_EXPORT}",
"schema_version":"2.0.1",
"product":"terraform",
"process_id":"${PROCESS_ID}",
"product_version":"${TFE_VERSION}",
"license_id":"${LICENSE_IDENTIFIER}",
"checksum": "${SHA}",
"metrics":{
"billable_rum_count":{
"key": "billable_rum_count",
"value": 1,
"mode": "write"
},
"billable_rum_count_workspace_80th_percentile":{
"key": "billable_rum_count_workspace_80th_percentile",
"value": 1,
"mode": "write"
},
"billable_rum_count_workspace_avg":{
"key": "billable_rum_count_workspace_avg",
"value": 1,
"mode": "write"
},
"billable_rum_count_workspace_max":{
"key": "billable_rum_count_workspace_max",
"value": 1,
"mode": "write"
},
"billable_rum_count_workspace_median":{
"key": "billable_rum_count_workspace_median",
"value": 1,
"mode": "write"
},
"billable_rum_count_workspace_min":{
"key": "billable_rum_count_workspace_min",
"value": 1,
"mode": "write"
},
"billable_rum_opt_in":{
"key": "billable_rum_opt_in",
"value": 1,
"mode": "write"
},
"ado_vcs_present":{
"key": "ado_vcs_present",
"value": 1,
"mode": "write"
},
"aws_provider_present":{
"key": "aws_provider_present",
"value": 1,
"mode": "write"
},
"azure_provider_present":{
"key": "azure_provider_present",
"value": 1,
"mode": "write"
},
"bitbucket_vcs_present":{
"key": "bitbucket_vcs_present",
"value": 1,
"mode": "write"
},
"continuous_validation_used_last_90_days":{
"key": "continuous_validation_used_last_90_days",
"value": 1,
"mode": "write"
},
"drift_detection_used_last_90_days":{
"key": "drift_detection_used_last_90_days",
"value": 1,
"mode": "write"
},
"gcp_provider_present":{
"key": "gcp_provider_present",
"value": 1,
"mode": "write"
},
"github_vcs_present":{
"key": "github_vcs_present",
"value": 1,
"mode": "write"
},
"gitlab_vcs_present":{
"key": "gitlab_vcs_present",
"value": 1,
"mode": "write"
},
"product_usage_reporting_opt_in":{
"key": "product_usage_reporting_opt_in",
"value": 1,
"mode": "write"
},
"run_tasks_used_last_90_days":{
"key": "run_tasks_used_last_90_days",
"value": 1,
"mode": "write"
},
"run_triggers_used_last_90_days":{
"key": "run_triggers_used_last_90_days",
"value": 1,
"mode": "write"
},
"sentinel_used_last_90_days":{
"key": "sentinel_used_last_90_days",
"value": 1,
"mode": "write"
},
"servicenow_catalog_billable_rum_count":{
"key": "servicenow_catalog_billable_rum_count",
"value": 1,
"mode": "write"
},
"servicenow_catalog_run_count":{
"key": "servicenow_catalog_run_count",
"value": 1,
"mode": "write"
},
"servicenow_catalog_workspace_count":{
"key": "servicenow_catalog_workspace_count",
"value": 1,
"mode": "write"
},
"teams_count":{
"key": "teams_count",
"value": 1,
"mode": "write"
},
"varsets_count":{
"key": "varsets_count",
"value": 1,
"mode": "write"
},
"workspacecount":{
"key": "workspacecount",
"value": 1,
"mode": "write"
},
"private_modules_count":{
"key":"private_modules_count",
"value": 1,
"mode":"write"
},
}
}
],
"metadata":{
}
}
}