Terragrunt Version Manager (tgenv)

Terragrunt version manager inspired by tfenv

Origin of my version of tgenv.

Support

Currently tgenv supports the following OSes

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

Installation

Automatic

Install via Homebrew

$ brew tap Estivador/tgenv
$ brew install tgenv

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

Manual

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

$ git clone https://github.com/Estivador/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.23.14
$ tgenv install latest
$ tgenv install latest:^0.23
$ tgenv install

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

Note: As of v0.18.1 Gruntwork provides signature verification. If you want to install older version, please set the envvar TGENV_IGNORE_SHA with any value. E.g. export TGENV_IGNORE_SHA=1

.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.23.14
$ tgenv use latest
$ tgenv use latest:^0.23

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.23.14
$ tgenv uninstall latest
$ tgenv uninstall latest:^0.23

tgenv list

List installed versions

% tgenv list
* 0.23.14 (set by /opt/tgenv/version)
  0.22.5
  0.21.13
  0.20.5

tgenv list-remote

List the 20 most recent installable versions

% tgenv list-remote
0.23.14
0.23.13
0.23.12
0.23.11
0.23.10
0.23.9
0.23.8
0.23.7
0.23.6
0.23.5
0.23.4
0.23.3
0.23.2
0.23.1
0.23.0
0.22.5
0.22.4
0.22.3
0.22.2
0.22.1
0.22.0

tgenv list-remote-all

List all of the installable versions

% tgenv list-remote-all
0.23.14
0.23.13
0.23.12
0.23.11
0.23.10
0.23.9
0.23.8
0.23.7
0.23.6
0.23.5
0.23.4
0.23.3
0.23.2
0.23.1
0.23.0
0.22.5
0.22.4
0.22.3
0.22.2
0.22.1
0.22.0
...