https://github.com/geerlingguy/docker-amazonlinux2-ansible

Amazon Linux 2 Docker container for Ansible playbook and role testing.
https://github.com/geerlingguy/docker-amazonlinux2-ansible

amazon-linux-2 amazonlinux ansible container docker hub linux testing

Last synced: 12 days ago
JSON representation

Amazon Linux 2 Docker container for Ansible playbook and role testing.

• Host: GitHub
• URL: https://github.com/geerlingguy/docker-amazonlinux2-ansible
• Owner: geerlingguy
• License: mit
• Created: 2018-10-29T03:02:32.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-11-18T18:32:24.000Z (almost 2 years ago)
• Last Synced: 2024-10-10T04:06:45.069Z (29 days ago)
• Topics: amazon-linux-2, amazonlinux, ansible, container, docker, hub, linux, testing
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/geerlingguy/docker-amazonlinux2-ansible/
• Size: 8.79 KB
• Stars: 23
• Watchers: 3
• Forks: 11
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Amazon Linux 2 Ansible Test Image

[![CI](https://github.com/geerlingguy/docker-amazonlinux2-ansible/workflows/Build/badge.svg?branch=master&event=push)](https://github.com/geerlingguy/docker-amazonlinux2-ansible/actions?query=workflow%3ABuild) [![Docker pulls](https://img.shields.io/docker/pulls/geerlingguy/docker-amazonlinux2-ansible)](https://hub.docker.com/r/geerlingguy/docker-amazonlinux2-ansible/)

Amazon Linux 2 Docker container for Ansible playbook and role testing.

## Tags

  - `latest`: Latest stable version of Ansible.

  - `testing`: Same as `latest`, but with additional testing dependencies, including:

    - `yamllint`

    - `ansible-lint`

    - `flake8`

    - `testinfra`

    - `molecule`

The latest tag is a lightweight image for basic validation of Ansible playbooks. The `testing` tag also includes a comprehensive suite of Ansible and infrastructure testing tools in case you want them pre-installed.

## How to Build

This image is built on Docker Hub automatically any time the upstream OS container is rebuilt, and any time a commit is made or merged to the `master` branch. But if you need to build the image on your own locally, do the following:

  1. [Install Docker](https://docs.docker.com/engine/installation/).

  2. `cd` into this directory.

  3. Run `docker build -t amazonlinux2-ansible .`

> Note: Switch between `master` and `testing` depending on whether you want the extra testing tools present in the resulting image.

## How to Use

  1. [Install Docker](https://docs.docker.com/engine/installation/).

  2. Pull this image from Docker Hub: `docker pull geerlingguy/docker-amazonlinux2-ansible:latest` (or use the image you built earlier, e.g. `amazonlinux2-ansible:latest`).

  3. Run a container from the image: `docker run --detach --privileged --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro geerlingguy/docker-amazonlinux2-ansible:latest` (to test my Ansible roles, I add in a volume mounted from the current working directory with ``--volume=`pwd`:/etc/ansible/roles/role_under_test:ro``).

  4. Use Ansible inside the container:

    a. `docker exec --tty [container_id] env TERM=xterm ansible --version`

    b. `docker exec --tty [container_id] env TERM=xterm ansible-playbook /path/to/ansible/playbook.yml --syntax-check`

## Notes

I use Docker to test my Ansible roles and playbooks on multiple OSes using CI tools like Jenkins and Travis. This container allows me to test roles and playbooks using Ansible running locally inside the container.

> **Important Note**: I use this image for testing in an isolated environment—not for production—and the settings and configuration used may not be suitable for a secure and performant production environment. Use on production servers/in the wild at your own risk!

## Author

Created in 2018 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).