This repository is a collection of Git hooks to be used with the pre-commit framework.
- Available Hooks
- Installation & Dependencies
- Usage
- Module Versioning
- About Terramate
- Reporting Issues
- Contributing
- Makefile Targets
- License
Currently, the following hooks are supported:
- terraform-fmt: The terraform fmt command is used to rewrite
Terraform configuration
*.tffiles to a canonical format and style. - terraform-validate: The terraform validate command validates
all Terraform configuration
*.tffiles, referring only to the configuration and not accessing any remote services such as remote state, provider APIs, etc. - tflint: TFLint is a Terraform linter focused on possible errors, best
practices, etc. (Terraform >= 0.12). Applied to all Terraform configuration
*.tffiles.
- golangci-lint: GolangCI-Lint is a linters aggregator. It's fast: on average 5 times faster than gometalinter. It's easy to integrate and use, has nice output and has a minimum number of false positives. An example configuration can be found in .golangci.example.yml.
The following hooks can be configured through golangci-lint and are therefore redundant when golangci-lint is being used
- gofmt: Go fmt is a tool that automatically formats Go
*.gofiles to canonical format and style. - goimports: The goimports command updates import lines in Go
*.gofiles, adding missing ones and removing unreferenced ones.
- phony-targets:
This hook validates if targets that are marked as
PHONYactually exist.
- markdown-link-check: Validates that all hyperlinks in a markdown text alive or dead.
- shellcheck: ShellCheck is a GPLv3 tool that gives warnings and suggestions for bash/sh shell scripts.
- terradoc-fmt: The terradoc fmt command is used to rewrite Terradoc
configuration configuration
*.tfdoc.hclfiles to a canonical format and style. - terradoc-generate: The terradoc generate command generates a markdown document
from Terradoc configuration
*.tfdoc.hclfiles. - terradoc-validate: The terradoc validate command is used validate Terradoc
configuration in
README.tfdoc.hclfile against Terraform variable definitions.
- terramate-fmt: The terramate generate command formats code in Terramate configuration files.
- terramate-generate: The terramate generate command generates code from Terramate configuration files.
-
Install pre-commit. E.g.
brew install pre-commit -
Install Terraform, TFLint, Go, markdown-link-check, shellcheck. E.g
brew install terraform \ tflint \ go \ golangci/tap/golangci-lint \ shellcheck && \ npm install -g markdown-link-check && \ go install github.com/mineiros-io/terradoc/cmd/terradoc@latest
Create a .pre-commit-config.yaml inside your repositories and add the desired list of hooks.
Please see the documentation for further information.
repos:
- repo: https://github.com/terramate-io/pre-commit-hooks
rev: <VERSION> # Check for the latest version: https://github.com/terramate-io/pre-commit-hooks/releases
hooks:
- id: terraform-fmt
- id: terraform-validate
- id: tflint
- id: golangci-lint
- id: phony-targets
- id: markdown-link-check
args: [-p] # When adding the -p flag, markdown-link-check will always with an exit code 0, even if dead links are found
- id: shellcheck
- id: terradoc-validate
- id: terradoc-fmt
- id: terradoc-generate
- id: terramate-generate
# The following hooks are redundant when golangci-lint is being. Our recommendation is to use golangci-lint
# as the main linter for go since it enables you to run all available linters in parallel.
# For details please see the example configuration https://github.com/terramate-io/pre-commit-hooks/blob/master/.golangci.example.yml
# - id: gofmt
# - id: goimportsOnce you created the configuration file inside your repository, you must run pre-commit install to activate the hooks.
That's it, pre-commit will now listen for changes in your files and run the checks accordingly.
It's usually a good idea to run the hooks against all of the files when adding new hooks (usually pre-commit will only run on the changed files during git hooks).
pre-commit run --all-filespre-commit run terraform-validate --all-filesIt's recommended to run pre-commit as part of CI pipeline/build as there will be always that one rebel in the team
who won't run them locally. On CI, replace pre-commit install by pre-commit run -a. We don't need to install it on
CI as it'll be a one-shot operation. run -a will run the hooks over all files (taking into account excludes if
configured).
All *.sh files inside pre_commit_hooks need to be flagged as executable. Otherwise the pre-commit hooks won't be
executable by default. You apply the flag to all *.sh files with the following command:
find pre_commit_hooks/ -type f -iname "*.sh" -exec chmod +x {} \;This Module follows the principles of Semantic Versioning (SemVer).
Using the given version number of MAJOR.MINOR.PATCH, we apply the following constructs:
- Use the
MAJORversion for incompatible changes. - Use the
MINORversion when adding functionality in a backwards compatible manner. - Use the
PATCHversion when introducing backwards compatible bug fixes.
- In the context of initial development, backwards compatibility in versions
0.0.zis not guaranteed whenzis increased. (Initial development) - In the context of pre-release, backwards compatibility in versions
0.y.zis not guaranteed whenyis increased. (Pre-release)
Terramate CLI is an open-source orchestration and code generation engine that allows Infrastructure as Code (IaC) such as Terraform, OpenTofu, Terragrunt and Kubernetes to scale.
Terramate CLI can optionally be paired with Terramate Cloud, a fully managed SaaS service that adds additional features to manage and observe all your infrastructure managed with IaC in one or multiple repositories.
With Terramate, you can:
- Break up large, monolithic state files into multiple smaller stacks to limit blast radius, reduce runtimes and unlock better collaboration.
- Reduce code duplication by programmatically generating native Terraform backend and provider configurations or any other arbitrary files using the Terramate compiler.
- Using a graph-based orchestration engine, orchestrate any command such as
terraform applyin stacks. Only deploy stacks that contain changes using change detection built on top of Git. - Automate your IaC using pull requests and GitOps workflows that turn your existing CI/CD, such as GitHub Actions, GitLab CI/CD, BitBucket Pipelines, Azure DevOps, etc, into infrastructure vending machines.
- Use Terramate Cloud to add observability, drift detection, asset management, misconfiguration detection, incident management, developer self-service with scaffolding, and Slack notifications.
We use GitHub Issues to track community reported issues and missing features.
Contributions are always encouraged and welcome! For the process of accepting changes, we use Pull Requests. If you'd like more information, please see our Contribution Guidelines.
This repository comes with a handy
Makefile.
Run make help to see details on each available target.
This module is licensed under the Apache License Version 2.0, January 2004. Please see LICENSE for full details.
Copyright © 2025 Terramate GmbH