Terraform version manager inspired by rbenv
Currently tfenv supports the following OSes
- Mac OS X (64bit)
- Linux
- 64bit
- Arm
- Windows (64bit) - only tested in git-bash
Install via Homebrew
$ brew install tfenv
Install via puppet
Using puppet module sergk-tfenv
include ::tfenv
- Check out tfenv into any path (here is
${HOME}/.tfenv
)
$ git clone https://github.com/kamatama41/tfenv.git ~/.tfenv
- Add
~/.tfenv/bin
to your$PATH
any way you like
$ echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> ~/.bash_profile
OR you can make symlinks for tfenv/bin/*
scripts into a path that is already added to your $PATH
(e.g. /usr/local/bin
) OSX/Linux Only!
$ ln -s ~/.tfenv/bin/* /usr/local/bin
Install a specific version of Terraform
latest
is a syntax to install latest version
latest:<regex>
is a syntax to install latest version matching regex (used by grep -e)
$ tfenv install 0.7.0
$ tfenv install latest
$ tfenv install latest:^0.8
If shasum is present in the path, tfenv will verify the download against Hashicorp's published sha256 hash. If keybase is available in the path it will also verify the signature for those published hashes using hashicorp's published public key.
If you use .terraform-version, tfenv install
(no argument) will install the version written in it.
Architecture other than the default amd64 can be specified with the TFENV_ARCH
environment variable
TFENV_ARCH=arm tfenv install 0.7.9
Switch a version to use
latest
is a syntax to use the latest installed version
latest:<regex>
is a syntax to use latest installed version matching regex (used by grep -e)
$ tfenv use 0.7.0
$ tfenv use latest
$ tfenv use latest:^0.8
Uninstall a specific version of Terraform
latest
is a syntax to uninstall latest version
latest:<regex>
is a syntax to uninstall latest version matching regex (used by grep -e)
$ tfenv uninstall 0.7.0
$ tfenv uninstall latest
$ tfenv uninstall latest:^0.8
List installed versions
% tfenv list
0.9.0-beta2
0.8.8
0.8.4
0.7.0
0.7.0-rc4
0.6.16
0.6.2
0.6.1
List installable versions
% tfenv list-remote
0.9.0-beta2
0.9.0-beta1
0.8.8
0.8.7
0.8.6
0.8.5
0.8.4
0.8.3
0.8.2
0.8.1
0.8.0
0.8.0-rc3
0.8.0-rc2
0.8.0-rc1
0.8.0-beta2
0.8.0-beta1
0.7.13
0.7.12
...
If you put .terraform-version
file on your project root, tfenv detects it and use the version written in it. If the version is latest
or latest:<regex>
, the latest matching version currently installed will be selected.
$ 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
$ echo latest:^0.8 > .terraform-version
$ terraform --version
Terraform v0.8.8
$ git --git-dir=~/.tfenv/.git pull
$ rm -rf /some/path/to/tfenv
- tfenv itself
- rbenv
- tfenv partially uses rbenv's source code