» Terraform Fmt Action
Runs terraform fmt
to validate all Terraform files in a directory are in the canonical format.
If any files differ, this action will comment back on the pull request with the diffs of each file.
» Success Criteria
This action succeeds if terraform fmt
runs without error.
» Usage
To use the fmt
action, add it to your workflow file.
action "terraform fmt" {
# Replace <latest tag> with the latest tag from
# https://github.com/hashicorp/terraform-github-actions/releases.
uses = "hashicorp/terraform-github-actions/fmt@<latest tag>"
# See Environment Variables below for details.
env = {
TF_ACTION_WORKING_DIR = "."
}
# We need the GitHub token to be able to comment back on the pull request.
secrets = ["GITHUB_TOKEN"]
}
» Environment Variables
Name | Default | Description |
---|---|---|
TF_ACTION_WORKING_DIR |
"." |
Which directory fmt runs in. Relative to the root of the repo. |
TF_ACTION_COMMENT |
"true" |
Set to "false" to disable commenting back on pull request with the diffs of unformatted files. |
» Secrets
The GITHUB_TOKEN
secret is required for posting a comment back to the pull request if fmt
fails.
If you have set TF_ACTION_COMMENT = "false"
, then GITHUB_TOKEN
is not required.
» Arguments
Any arguments will be appended to the terraform fmt
command; however, we do not anticipate that this will be needed.