How To Manage Terraform Versions

Tenv is a version manager for Terraform, OpenTofu, Terragrunt, and Atmos. In one command it can detect and install the Terraform version without any actions.

The simplest method for handling Terraform versions is to tenv. tenv is a version manager for Terraform, OpenTofu, Terragrunt, and Atmos, which are written in Go. This versatile version manager simplifies the complexity of version control, helping to avoid spending time on IaC tools’ version management and ensuring developers and DevOps can focus on what is important the most — crafting innovative products and driving business value.

Why Do I Need Terraform Version Manager?

Managing a single Terraform project makes installing, upgrading, or switching to tools like OpenTofu straightforward. However, handling multiple projects with different Terraform versions can be challenging. Regular upgrades and tool switches require careful coordination to maintain functionality and stability across projects. The list of key challenges:

• Version compatibility: Different projects may need specific Terraform versions, which might not be backward compatible.
• Dependency management: Dependencies for each project must match the Terraform version of that project.
• Environment consistency: It becomes challenging to maintain consistency throughout the development, staging, and production environments.
• Tooling and integration: Various Terraform versions may require modifications to CI/CD pipelines and integrations.

tenv Terraform version manager covers all described challenges under the hood in a single binary that helps to manage Terraform versions transparently.

Tenv Version Manager Installation

MacOS

brew install tenv

Windows

choco install tenv

Linux

For Linux, you can install the tenv version manager via packaged binaries (.deb, .rpm, .apk, pkg.tar.zst , .zip or .tar.gz format) by visiting the release page or by apk/yay/snap/nix package managers. To get more information about the Linux tenv installation, check README.md.

Manage Terraform Versions via Tenv Version Manager

Manage Terraform Version Like a Pro

Once you have the tenv version manager installed, you can use it to install specific versions of Terraform. To install Terraform, do the following steps:

Open a terminal, go to the directory with Terraform code (if you have any), and execute the following command to install Terraform version:

$ tenv tf install

No version files found for Terraform, fallback to latest strategy

Fetching all releases information from https://releases.hashicorp.com/terraform/index.json

Found compatible version remotely : 1.8.5

Installing Terraform 1.8.5

Fetching release information from https://releases.hashicorp.com/terraform/1.8.5/index.json

Downloading https://releases.hashicorp.com/terraform/1.8.5/terraform_1.8.5_darwin_amd64.zip

Downloading https://releases.hashicorp.com/terraform/1.8.5/terraform_1.8.5_SHA256SUMS

Downloading https://releases.hashicorp.com/terraform/1.8.5/terraform_1.8.5_SHA256SUMS.sig

Downloading https://www.hashicorp.com/.well-known/pgp-key.txt

Installation of Terraform 1.8.5 successful

Based on .tf code, the tenv version manager automatically detects and installs the necessary version of Terraform.  If no version is detected in sources, the latest version will be installed.

On the other hand, if necessary, a specific Terraform version can also be installed. Let's try to install Terraform 1.5.7:

$ tenv tf install 1.5.7

Installing Terraform 1.5.7

Fetching release information from https://releases.hashicorp.com/terraform/1.5.7/index.json

Downloading https://releases.hashicorp.com/terraform/1.5.7/terraform_1.5.7_darwin_amd64.zip

Downloading https://releases.hashicorp.com/terraform/1.5.7/terraform_1.5.7_SHA256SUMS

Downloading https://releases.hashicorp.com/terraform/1.5.7/terraform_1.5.7_SHA256SUMS.sig

Downloading https://www.hashicorp.com/.well-known/pgp-key.txt

Installation of Terraform 1.5.7 successful

The install command also supports version constraints such as:

• latest : the latest available stable version
• latest-pre : the latest available version, including unstable ones
• latest-allowed or min-required: tenv will scan your Terraform files to detect which version is maximally allowed or minimally required.

As the last step, verify the Terraform version. To do it, use the following command:

$ terraform version

Terraform v1.8.5

on darwin_amd64

That's it. No symlinks, additional commands, or custom downloads are required. To read about more installation cases for Terraform, you can check the official README.md file.

We ZippyOPS Provide consulting, implementation, and management services on DevOps, DevSecOps, DataOps, MLOps, AIOps, Cloud, Automated Ops, Microservices, Infrastructure, and Security

Services offered by us: https://www.zippyops.com/services

Our Products: https://www.zippyops.com/products

Our Solutions: https://www.zippyops.com/solutions

For Demo, videos check out YouTube Playlist: https://www.youtube.com/watch?v=4FYvPooN_Tg&list=PLCJ3JpanNyCfXlHahZhYgJH9-rV6ouPro

If this seems interesting, please email us at [email protected] for a quick call.

Relevant Blogs:

Impact of Terraform in Devops 

Terraform execution in pipeline 

Terraform Best Practices: The 20 Practices You Should Adopt