Introduction
This article explains why the `:latest` or `n-1` tags are not supported for downloading the Terraform Enterprise Docker image and emphasises the importance of explicitly pinning the version in your Docker Compose configuration.
Prerequisites
- Terraform Enterprise
- Docker and Docker Compose setup
- Access to Terraform Enterprise Docker images via HashiCorp Releases
Use Case
Organizations deploying Terraform Enterprise using Docker Compose and looking to manage version control and stability during upgrades.
Procedure
Step 1: Understand Why `:latest` and `n-1` Tags Are Unsupported
HashiCorp does not support `:latest` or `n-1` tags for TFE Docker images to avoid unintentional upgrades. These tags are commonly used in other projects to pull the most recent version, but TFE requires stricter versioning to maintain stability.
Step 2: Identify the Required TFE Version
Go to the official Terraform Enterprise Release Page and choose the version that meets your environment’s requirements.
Step 3: Pin the Image Version in Docker Compose
image: images.releases.hashicorp.com/hashicorp/terraform-enterprise:v2024011-1
This ensures that Docker always pulls the specified version, protecting your deployment from automatic upgrades.
Step 4: Test Before Deploying in Production
Before updating production systems, test the pinned version in a staging environment. This step allows you to validate compatibility and ensure your infrastructure behaves as expected with the new version.
Additional Information
https://developer.hashicorp.com/terraform/enterprise/releases