All #awesome-ci Docker images
ansible • ansible-lint • awesome-ci • black • checkmake • eslint • file-lint • gofmt • goimports • golint • jsonlint • phpcbf • phpcs • php-cs-fixer • pycodestyle • pylint • terraform-docs • terragrunt • terragrunt-fmt • yamllint
All #awesome-ci Makefiles
Visit cytopia/makefiles for seamless project integration, minimum required best-practice code linting and CI.
View Dockerfile on GitHub.
Tiny Alpine-based multistage-build dockerized version of Terragrunt[1] and its compatible version of Terraform[2].
- [1] Official project: https://github.com/gruntwork-io/terragrunt
- [2] Official project: https://github.com/hashicorp/terraform
The following Docker image tags are rolling releases and built and updated nightly. This means they always contain the latest stable version as shown below.
| Docker tag | Terraform version | Terragrunt version |
|---|---|---|
latest |
latest stable | latest stable |
0.12-0.19 |
latest stable 0.12.x |
latest stable 0.19.x |
0.11-0.18 |
latest stable 0.11.x |
latest stable 0.18.x |
If you want to ensure to have reproducible Terraform/Terragrunt executions you should use a git tag from this repository. Tags are incremented for each new version, but never updated itself. This means you will have to take care yourself and update your CI tools every time a new tag is being released.
| Docker tag | docker-terragrunt | Terraform version | Terragrunt version |
|---|---|---|---|
latest-<tag> |
Tag: <tag> |
latest stable during tag creation | latest stable during tag creation |
0.12-0.19-<tag> |
Tag: <tag> |
latest stable 0.12.x during tag creation |
latest stable 0.12.x during tag creation |
0.11-0.18-<tag> |
Tag: <tag> |
latest stable 0.11.x during tag creation |
latest stable 0.11.x during tag creation |
Where <tag> refers to the chosen git tag from this repository.
The working directory inside the Docker container is /data/ and should be mounted to your local filesystem where your Terragrant project resides.
(See Examples for mount location usage.)
docker run --rm -v $(pwd):/data cytopia/terragrunt terragrunt <ARGS>
docker run --rm -v $(pwd):/data cytopia/terragrunt terraform <ARGS>Let's assume your Terragrunt project setup is as follows:
/my/tf # Terragrunt project root
├── backend-app
│ ├── main.tf
│ └── terragrunt.hcl
├── frontend-app
│ ├── main.tf
│ └── terragrunt.hcl
├── mysql # MySQL sub-project directory
│ ├── main.tf
│ └── terragrunt.hcl
├── redis
│ ├── main.tf
│ └── terragrunt.hcl
└── vpc
├── main.tf
└── terragrunt.hclThe MySQL sub-project you want to provision is at the releative path mysql/.
- Mount the terragrunt root project dir (
/my/tf/) into/data/into the container - Use the workding dir (
-wor--workdir) to point to your project inside the container - Add AWS credentials from your environment to the container
# Initialize the MySQL project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/mysql \
cytopia/terragrunt terragrunt init
# Plan the MySQL project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/mysql \
cytopia/terragrunt terragrunt plan
# Apply the MySQL project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/mysql \
cytopia/terragrunt terragrunt --terragrunt-non-interactive applyLet's assume your Terragrunt project setup is as follows:
/my/tf # Terragrunt project root
└── envs
└── aws
├── dev
│ ├── eu-central-1
│ │ ├── infra
│ │ │ └── vpc-k8s # VPC sub-project directory
│ │ │ ├── terraform.tfvars
│ │ │ └── terragrunt.hcl
│ │ ├── microservices
│ │ │ └── api-gateway
│ │ │ ├── terraform.tfvars
│ │ │ └── terragrunt.hcl
│ │ └── region.tfvars
│ ├── global
│ │ └── region.tfvars
│ └── terragrunt.hcl
└── _provider_include
└── include_providers.tfThe VPC sub-project you want to provision is at the relative path envs/aws/dev/eu-centra-1/infra/vpc-k8s/.
- Mount the terragrunt root project dir (
/my/tf/) into/data/into the container - Use the workding dir (
-wor--workdir) to point to your project inside the container - Add AWS credentials from your environment to the container
# Initialize the VPC project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/envs/aws/dev/eu-central-1/infra/vpc-k8s \
cytopia/terragrunt terragrunt init
# Plan the VPC project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/envs/aws/dev/eu-central-1/infra/vpc-k8s \
cytopia/terragrunt terragrunt plan
# Apply the VPC project
docker run --rm \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-v /my/tf:/data \
-w /data/envs/aws/dev/eu-central-1/infra/vpc-k8s \
cytopia/terragrunt terragrunt --terragrunt-non-interactive applyRelated #awesome-ci projects
Save yourself from installing lot's of dependencies and pick a dockerized version of your favourite linter below for reproducible local or remote CI tests:
| Docker image | Type | Description |
|---|---|---|
| awesome-ci | Basic | Tools for git, file and static source code analysis |
| file-lint | Basic | Baisc source code analysis |
| jsonlint | Basic | Lint JSON files [1] |
| yamllint | Basic | Lint Yaml files |
| ansible | Ansible | Multiple versoins of Ansible |
| ansible-lint | Ansible | Lint Ansible |
| gofmt | Go | Format Go source code [1] |
| goimports | Go | Format Go source code [1] |
| golint | Go | Lint Go code |
| eslint | Javascript | Lint Javascript code |
| checkmake | Make | Lint Makefiles |
| phpcbf | PHP | PHP Code Beautifier and Fixer |
| phpcs | PHP | PHP Code Sniffer |
| php-cs-fixer | PHP | PHP Coding Standards Fixer |
| black | Python | The uncompromising Python code formatter |
| pycodestyle | Python | Python style guide checker |
| pylint | Python | Python source code, bug and quality checker |
| terraform-docs | Terraform | Terraform doc generator (TF 0.12 ready) [1] |
| terragrunt | Terraform | Terragrunt and Terraform |
| terragrunt-fmt | Terraform | terraform fmt for Terragrunt files [1] |
[1] Uses a shell wrapper to add enhanced functionality not available by original project.
Visit cytopia/makefiles for dependency-less, seamless project integration and minimum required best-practice code linting for CI. The provided Makefiles will only require GNU Make and Docker itself removing the need to install anything else.
Copyright (c) 2019 cytopia