Simplify your Provider version upgrades with Terrap - a powerful CLI tool that scans your system and identifies any required changes.
The tool offers clear and actionable notifications, helping you streamline the upgrade process and avoid any potential errors or complications.
🔍 Terrap is an alpha version project, therefore some data might be partial.
- Documentation - sirrend.com/terrap-docs
- Supported Terraform Core versions:
>=0.13
. - Every provider which uses
Terraform Core 0.13
or higher.
Terrap decides which Terraform version to use in the following order:
-
The latest installed Terraform version found locally.
-
If the
TERRAP_TERRAFORM_VERSION
environment variable is set, Terrap will use the version specified as long as it matches the>=0.13
constraint.
Set environment variable on mac/linux:export <var>=<value>
Set environment variable on windows:
$Env:TERRAP_TERRAFORM_VERSION = "0.13"
-
If none of the above is applicable, Terrap will download the latest available version.
git clone https://github.com/sirrend/terrap-cli
cd terrap-cli
go build -o terrap .
chmod +x terrap
mv terrap /usr/local/bin/
brew tap sirrend/products
brew install terrap
Validate terrap is working by executing terrap
.
-
CD
to the local Terraform folder you want to work with.
cd < /terraform/folder/path >
-
Initialize a new Terrap workspace where you would run terraform apply with
terrap init
.
Important!
As Terrap runsterraform init
under the hood, it would need every configuration component you normally use when executing the command.
It can be environment variables, the.aws/credentials
file, etc. -
Scan your workspace with:
terrap scan
quickstart.mov
Scan your infrastructure for changes in the following provider version for a safe and easy upgrade!
Looking for a specific resource type changes? Use the --data-sources
--resources
and --provider
flags.
Ready to explore what's new in the following version of your provider? Simply execute terrap whats-new
.
Looking to delve into a specific version of your provider? Specify the desired version with --fixed-providers <provider>:<version>
to explore what's new and improved.
Run terrap providers get-supported
to get a list of all supported providers and version ranges.
You can use the --filter
flag if you're looking for something specific.
- Bulk updates - straight to a version of your choosing.
- Automatic Upgrades - you write, Terrap upgrades.
- Expanding Terrap's providers support.
You can open an issue either directly from the CLI using terrap open-issue
or through the GitHub UI.
- Checkout from the
main
branch. - Add your code with the proper documentation.
- Open a PR with a detailed explanation of the functionality you want to add.