tfenv

Terraform version manager inspired by rbenv

Support

Currently tfenv supports the following OSes

• Mac OS X (64bit)
• Linux (64bit)

Installation

1. Check out tfenv into any path

$ git clone https://github.com/kamatama41/tfenv.git /some/path/to/tfenv

2. Add /some/path/to/tfenv/bin to your $PATH

This is an example of adding .zshrc

if [ -f /some/path/to/tfenv/bin/tfenv ]; then
  path=(/some/path/to/tfenv/bin $path)
fi

OR you can make symlinks for tfenv/bin/* scripts into a path that is already added to your $PATH (e.g. /usr/local/bin)

ln -s /some/path/to/tfenv/bin/* /usr/local/bin

Usage

tfenv install

Install a specific version of Terraform
latest is a syntax to install latest version

$ tfenv install 0.7.0
$ tfenv install latest

If you use .terraform-version, tfenv install (no argument) will install the version written in it.

tfenv use

Switch a version to use

$ tfenv use 0.7.0

tfenv list

List installed versions

% tfenv list
0.7.0
0.7.0-rc4
0.6.16
0.6.2
0.6.1

tfenv list-remote

List installable versions

% tfenv list-remote
0.7.0
0.7.0-rc4
0.7.0-rc3
0.7.0-rc2
0.7.0-rc1
0.6.16
0.6.15
0.6.14
0.6.13
...

.terraform-version

If you put .terraform-version file on your project root, tfenv detects it and use the version written in it.

$ cat .terraform-version
0.6.16

$ terraform --version
Terraform v0.6.16

Your version of Terraform is out of date! The latest version
is 0.7.3. You can update by downloading from www.terraform.io

$ echo 0.7.3 > .terraform-version

$ terraform --version
Terraform v0.7.3

Upgrading

$ git --git-dir=/some/path/to/tfenv/.git pull

Uninstalling

$ rm -rf /some/path/to/tfenv

LICENSE

• tfenv itself
• rbenv
  • tfenv partially uses rbenv's source code