Awesome
Terraform Switcher
<img style="text-align:center" src="https://s3.us-east-2.amazonaws.com/kepler-images/warrensbox/tfswitch/smallerlogo.png" alt="drawing" width="120" height="130"/>The tfswitch
command line tool lets you switch between different versions of Terraform.
If you do not have a particular version of Terraform installed, tfswitch
will download and verify the version you desire.
The installation is minimal and easy.
Once installed, simply select the version you require from the dropdown and start using Terraform.
Documentation
Click here for our extended documentation.
NOTE
Going forward we will change the version identifier of tfswitch
to align with the common go package versioning.
Please be advised to change any automated implementation you might have that is relying on the tfswitch
version string.
Old version string: 0.1.2412
New version string: v1.0.0
Note the v
that is preceding all version numbers.
Installation
tfswitch
is available as a binary and on various package managers (eg. Homebrew).
Windows
Download and extract the Windows version of tfswitch
that is compatible with your system.
We are building binaries for 386, amd64, arm6 and arm7 CPU structure.
See the release page for your download.
Homebrew
For macOS or various Linux distributions, Homebrew offers the simplest installation process. <a href="https://brew.sh/" target="_blank">If you do not have homebrew installed, click here</a>.
brew install warrensbox/tap/tfswitch
Linux
Installation for Linux operating systems.
curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash
Arch User Repository (AUR) packages for Arch Linux
# compiled from source
yay tfswitch
# precompiled
yay tfswitch-bin
Install from source
Alternatively, you can install the binary from the source <a href="https://github.com/warrensbox/terraform-switcher/releases" target="_blank">here</a>.
See our installation documentation for more details.
[!IMPORTANT] The version identifier of
tfswitch
has changed to align with the commongo
package versioning.Version numbers will now be prefixed with a
v
- eg.v1.0.3
.Please change any automated implementations relying on the
tfswitch
version string.Old version string:
0.1.2412
New version string:v1.0.3
Quick Start
Dropdown Menu
Execute tfswitch
and select the desired Terraform version via the dropdown menu.
Version on command line
Use tfswitch 1.7.0
to install Terraform version 1.7.0. Replace the version number as required.
More usage guide here
How to contribute
An open source project becomes meaningful when people collaborate to improve the code.
Feel free to look at the code, critique and make suggestions. Let's make tfswitch
better!
See step-by-step instructions on how to contribute here: Contribute
Additional Info
See how to upgrade and uninstall or troubleshoot
Issues
Please open issues here: New Issue