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

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

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

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
...