Terragrunt Version Manager (tgenv)

Terragrunt version manager inspired by tfenv

Support

Currently tgenv supports the following OSes

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

Installation

Automatic

Install via Homebrew

$ brew tap sigsegv13/tgenv
$ brew install tgenv

Note: The Hombrew tap is maintained here: sigsegv13/homebrew-tgenv

Manual

1. Check out tgenv into any path (here is ${HOME}/.tgenv)

$ git clone https://github.com/sigsegv13/tgenv.git ~/.tgenv

2. Add ~/.tgenv/bin to your $PATH any way you like

$ echo 'export PATH="$HOME/.tgenv/bin:$PATH"' >> ~/.bash_profile

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

$ ln -s ~/.tgenv/bin/* /usr/local/bin

On Ubuntu/Debian touching /usr/local/bin might require sudo access, but you can create ${HOME}/bin or ${HOME}/.local/bin and on next login it will get added to the session $PATH or by running . ${HOME}/.profile it will get added to the current shell session's $PATH.

$ mkdir -p ~/.local/bin/
$ . ~/.profile
$ ln -s ~/.tgenv/bin/* ~/.local/bin
$ which tgenv

Usage

tgenv install [version]

Install a specific version of Terragrunt. Available options for version:

• i.j.k exact version to install
• latest is a syntax to install latest version
• latest:<regex> is a syntax to install latest version matching regex (used by grep -e)
• min-required is currently not supported as it is not yet a feature of Terragrunt. See Ensure minimum Terragrunt version #182.

$ tgenv install 0.12.12
$ tgenv install latest
$ tgenv install latest:^0.9
$ tgenv install

If shasum is present in the path, tgenv will verify the download against Gruntwork's published sha256 hash.

Note: Signature verification does not work as it seems Gruntwork currently does no publish a signature.

.terragrunt-version

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

min-required

Currently not supported as it is not yet a feature of Terragrunt. See Ensure minimum Terragrunt version #182 to voice your support for this feature or even contribute to help make it happen.

tgenv use <version>

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)

$ tgenv use 0.12.1
$ tgenv use latest
$ tgenv use latest:^0.10

tgenv uninstall <version>

Uninstall a specific version of terragrunt latest is a syntax to uninstall latest version latest:<regex> is a syntax to uninstall latest version matching regex (used by grep -e)

$ tgenv uninstall 0.12.1
$ tgenv uninstall latest
$ tgenv uninstall latest:^0.10

tgenv list

List installed versions

% tgenv list
* 0.12.15 (set by /opt/tgenv/version)
  0.12.8
  0.10.0
  0.9.9

tgenv list-remote

List the 20 most recent installable versions

% tgenv list-remote
0.12.15
0.12.14
0.12.13
0.12.12
0.12.11
0.12.10
0.12.9
0.12.8
0.12.7
0.12.6
0.12.5
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.1
0.11.0
0.10.3
0.10.2

tgenv list-remote-all

List all of the installable versions

% tgenv list-remote-all
0.12.15
0.12.14
0.12.13
0.12.12
0.12.11
0.12.10
0.12.9
0.12.8
0.12.7
0.12.6
0.12.5
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.1
0.11.0
0.10.3
0.10.2
...

.terragrunt-version

If you put .terragrunt-version file on your project root, or in your home directory, tgenv detects it and uses the version written in it. If the version is latest or latest:<regex>, the latest matching version currently installed will be selected.

$ tgenv list
  0.12.15
  0.10.3
* 0.9.9 (set by /home/user/.terragrunt-version)

$ cat .terragrunt-version
0.9.9

$ terragrunt --version
terragrunt version v0.9.9

$ echo 0.12.15 > .terragrunt-version

$ terragrunt --version
terragrunt v0.12.15

$ echo latest:^0.10 > .terragrunt-version

$ terragrunt --version
terragrunt v0.10.3

Upgrading

Automatic

Upgrading via Homebrew

$ brew update                    # Updates the tap
$ brew upgrade tgenv             # Upgrades the app

Manual

$ git --git-dir=~/.tgenv/.git pull

Uninstalling

Automatic

Uninstalling via Homebrew

$ brew uninstall tgenv           # Uninstalls tgenv and associated Terragrunt release(s)
$ brew untap sigsegv13/tgenv     # Removes the tap

Manual

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

LICENSE

• tgenv : My version of tgenv
• tgenv source : Origin of my version of tgenv
• tfenv : tgenv is based on tfenv's source code