tfvm

README

tfvm

A Terraform Version Manager written in Go

Table of Contents

• tfvm
  • Table of Contents
  • Features
  • Changelog
  • How it Works
  • Getting Started
    • Installation
    • CLI Usage
  • Contributing
    • Development

Features

• Easily manage multiple terraform versions to use across projects.
• Run tfvm use with no version argument to switch to the version specified in the current directory's .tfversion file.
• Works on Linux, Mac, and Windows.

Changelog

See the CHANGELOG

How it Works

tfvm installs and manages different versions of terraform in the CLI.

Getting Started

Installation

Linux or Mac users can install via the install script (requires both curl and wget):

wget -q -O - https://raw.githubusercontent.com/ethanhassett/tfvm/main/install.sh | bash

Running the install script after installation will keep tfvm updated.

Using go get:

go get -u github.com/ethanhassett/tfvm@v1.3.1

This will require manually adding <USER_HOME>/.tfvm to PATH.

Run tfvm --version to verify installation.

CLI Usage

$ tfvm --help

Usage: tfvm [--version] [--help] <command> [<args>]

Available commands are:
    install    Install a version of Terraform
    list       List all installed versions of Terraform
    remove     Remove a specific version of Terraform
    use        Select a version of Terraform to use

Contributing

Contributions to this project are welcome and much appreciated!

Development

1. Use Golang version 1.16
2. Fork this repo
3. Commit and push your changes, using proper commit prefixes found below.
   • fix:
   • feat:
   • doc:
4. Open a Pull Request, rebasing against main if needed.

Bugs, feature requests, and comments are more than welcome in the issues.