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

Auto-trigger docker build for terragrunt when new terraform version released
https://github.com/alpine-docker/terragrunt

alpine docker-image landscape terraform terraform-landscape terragrunt

Last synced: about 1 month ago
JSON representation

Auto-trigger docker build for terragrunt when new terraform version released

• Host: GitHub
• URL: https://github.com/alpine-docker/terragrunt
• Owner: alpine-docker
• License: apache-2.0
• Created: 2019-02-08T02:26:20.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-05-10T05:47:00.000Z (8 months ago)
• Last Synced: 2024-05-10T06:39:00.260Z (8 months ago)
• Topics: alpine, docker-image, landscape, terraform, terraform-landscape, terragrunt
• Language: Shell
• Size: 47.9 KB
• Stars: 32
• Watchers: 2
• Forks: 24
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# enhanced tool to manage terraform deployment with terragrunt

[If enjoy, please consider buying me a coffee.](https://www.buymeacoffee.com/ozbillwang)

Auto-trigger docker build for [terragrunt](https://github.com/gruntwork-io/terragrunt) when new terraform version is related.

[![DockerHub Badge](http://dockeri.co/image/alpine/terragrunt)](https://hub.docker.com/r/alpine/terragrunt/)

### 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](https://terraform.io) - terraform version is this docker image's tag

* [terragrunt](https://github.com/gruntwork-io/terragrunt) - The latest terragrunt version when running the build.

* [boilerplate](https://github.com/gruntwork-io/boilerplate) - The latest boilerplate version when running the build.

* [terraform-docs](https://github.com/terraform-docs/terraform-docs) - The latest terraform-docs version when running the build.

* (TODO, not ready yet) [OpenTofu](https://opentofu.org/docs/intro/install/) - 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