README
¶
Infracost shows hourly and monthly cost estimates for a Terraform project. This helps developers, DevOps et al. quickly see the cost breakdown and compare different deployment options upfront.
Table of Contents
Checkout the docs site for detailed usage options, supported resources and more information.
Installation
To download and install the latest release:
curl --silent --location "https://github.com/infracost/infracost/releases/latest/download/infracost-$(uname -s)-amd64.tar.gz" | tar xz -C /tmp
sudo mv /tmp/infracost-$(uname -s | tr '[:upper:]' '[:lower:]')-amd64 /usr/local/bin/infracost
Basic usage
Generate a cost breakdown from a Terraform directory:
infracost --tfdir examples/terraform
Check the docs site for more details.
The Infracost GitHub action can be used to automatically add a PR comment showing the cost estimate diff between a pull request and the master branch whenever Terraform files change.
Development
Install Go dependencies:
make deps
Install latest version of terraform-provider-infracost. If you want to use a local development version see #using-a-local-version-of-terraform-provider-infracost
make install_provider
Run the code:
make run ARGS="--tfdir <Terraform Dir>"
Run all tests:
make test
Exclude integration tests:
make test ARGS="-v -short"
Build:
make build
Using a local version of terraform-provider-infracost
To use a local development version of terraform-provider-infracost
-
Fork/clone the terraform-provider-infracost repository
-
Inside the directory that you cloned the repository run the following to install the local version in your
~/.terraform.d/pluginsdirectory:
make install
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Join our chat, we are a friendly bunch and happy to help you get started :) https://discord.gg/rXCTaH3
Directories