Terrap - a powerful CLI tool that scans your infrastructure and identifies any required changes.
APACHE-2.0 License
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.
>=0.13
.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 runs terraform 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
scan
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.
whats-new
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.
You can open an issue either directly from the CLI using terrap open-issue
or through the GitHub UI.
main
branch.