devkrolikowski/iac-tools repository overview

⁠IAC Tools Docker Image

A Docker image containing essential Infrastructure as Code (IAC) tools for automating infrastructure management and deployment.

⁠Overview

This Docker image is based on Ubuntu 24.04 and includes popular IAC tools commonly used in DevOps workflows:

• Terraform - Infrastructure provisioning tool
• Terragrunt - Terraform wrapper for managing multiple environments
• Ansible - Configuration management and automation tool
• Vault - Hashicorp vault binary

⁠Included Tools

⁠Additional Packages

• Git - Version control system
• Curl - Command line tool for transferring data
• Wget - Commandline tool for downloading data
• GPG - Data encryption
• JQ - Command line JSON processor
• Unzip - Archive extraction utility
• Pipx - Tool for installing and running Python applications in isolated environments

⁠Usage

⁠Pull the image

# From Docker Hub (after CI/CD setup)
docker pull <your-dockerhub-username>/iac-tools:latest

# Or build locally
docker build -t iac-tools:latest .

⁠Run the container

# Interactive shell
docker run -it --rm iac-tools:latest /bin/bash

# Mount your workspace
docker run -it --rm -v $(pwd):/workspace -w /workspace iac-tools:latest /bin/bash

# Run specific commands
docker run --rm -v $(pwd):/workspace -w /workspace iac-tools:latest terraform --version
docker run --rm -v $(pwd):/workspace -w /workspace iac-tools:latest terragrunt --version
docker run --rm -v $(pwd):/workspace -w /workspace iac-tools:latest ansible --version

⁠Docker Compose

You can also use this image with Docker Compose:

version: "3.8"
services:
  iac-tools:
    image: iac-tools:latest
    volumes:
      - .:/workspace
    working_dir: /workspace
    stdin_open: true
    tty: true

⁠Building the Image

⁠Local Build

To build the image locally:

docker build -t iac-tools:latest .

⁠Automated CI/CD

This repository includes a GitHub Actions workflow that automatically:

• Builds multi-platform Docker images (amd64/arm64) on every push
• Tests all included tools (Terraform, Terragrunt, Ansible, Git)
• Performs security vulnerability scanning
• Publishes to Docker Hub on main branch and tags

See GITHUB_ACTIONS_SETUP.md⁠ for detailed setup instructions.

⁠Environment Variables

• DEBIAN_FRONTEND=noninteractive - Prevents interactive prompts during package installation
• TERRAGRUNT_VERSION=v0.77.22 - Specifies the Terragrunt version to install
• TF_VERSION=1.11.4 - Specifies the Terraform version to install
• ARCH=amd64 - Target architecture
• OS=linux - Target operating system
• PATH - Includes /root/.local/bin for pipx-installed tools

⁠Use Cases

This image is ideal for:

• CI/CD pipelines requiring infrastructure automation
• Development environments for IAC workflows
• Consistent tooling across different environments
• Containerized infrastructure deployments
• Learning and experimenting with IAC tools

⁠Security

• The image runs as root user (default for this use case)
• Base image is Ubuntu 24.04 with latest security updates
• Only essential packages are installed to minimize attack surface

⁠Maintenance

• Maintainer: Krzysztof Królikowski [email protected]⁠
• Version: 1.0
• Base Image: Ubuntu 24.04

⁠License

See the LICENSE⁠ file for license information.

⁠Contributing

Feel free to submit issues and enhancement requests!