enhanced tool to manage terraform deployment with terragrunt

If enjoy, please consider buying me a coffee.

Auto-trigger docker build for terragrunt when new terraform version is related.

Notes

• Never use tag latest in prod environment.
• Multi-Arch supported (linux/amd64, linux/arm64)
• For examples, below tags are supported now:

- alpine/terragrunt:latest - alpine/terragrunt:1.8.4 (terraform version) - alpine/terragrunt:tf1.8.4 (terraform version) - (TODO, not ready yet) alpine/terragrunt:otf1.7.1 (opentofu version)

Tools included in this container

• terraform - terraform version is this docker image's tag
• terragrunt - The latest terragrunt version when running the build.
• boilerplate - The latest boilerplate version when running the build.
• terraform-docs - The latest terraform-docs version when running the build.
• (TODO, not ready yet) OpenTofu - the latest opentofu version when running the build

Repo:

https://github.com/alpine-docker/terragrunt

Daily build logs:

https://github.com/alpine-docker/terragrunt/actions

Docker image tags:

https://hub.docker.com/r/alpine/terragrunt/tags/

Multiple platforms supported

• linux/arm64
• linux/amd64

Why we need it

This is mostly used during Continuous Integration and Continuous Delivery (CI/CD), or as a component of an automated build and deployment process.

Usage:

# (1) must mount the local folder to /apps in container. # (2) must mount the aws credentials and ssh config folder in container. $ docker run -ti --rm -v $HOME/.aws:/root/.aws -v ${HOME}/.ssh:/root/.ssh -v pwd:/apps alpine/terragrunt:0.12.16 bash # # common terraform steps $ terraform init $ terraform fmt $ terraform validate $ terraform plan $ terraform apply # common opentofu steps $ tofu init $ tofu fmt $ tofu validate $ tofu plan $ tofu apply # common terragrunt steps # cd to terragrunt configuration directory, if required. # Terraform and OpenTofu Version Compatibility Table # https://terragrunt.gruntwork.io/docs/getting-started/supported-versions/ $ terragrunt hclfmt $ terragrunt run-all plan $ terragrunt run-all apply

The Processes to build this image

• Enable CI cronjob on this repo to run build weekly on master branch
• Check if there are new versions announced via Terraform Github REST API
• Match the exist docker image tags via Hub.docker.io REST API
• If not matched, build the image with latest terraform version as tag and push to hub.docker.com
• Always install latest version of terragrunt