epicsoft/ansible repository overview

⁠Ansible

This Docker image is managed and kept up to date by epicsoft LLC⁠.

Ansible in an Alpine Linux container, based on the official python image - as a CI image or to run playbooks on any machine with Docker. The -plugins variant adds commonly used collections.

• Base image: https://hub.docker.com/_/python⁠ (python:3.14-alpine3.24), platforms linux/amd64 and linux/arm64
• Dockerfiles: https://gitlab.com/epicsoft-networks/ansible/-/tree/master⁠
• Repository: https://gitlab.com/epicsoft-networks/ansible⁠, mirrored to GitHub⁠ — issues are welcome on both; code changes only as merge requests on GitLab, the mirror overwrites anything pushed to GitHub
• Container registry: https://gitlab.com/epicsoft-networks/ansible/container_registry⁠
• Docker Hub: https://hub.docker.com/r/epicsoft/ansible⁠
• Changelog: https://gitlab.com/epicsoft-networks/ansible/-/blob/master/CHANGELOG.md⁠
• License: MIT

⁠Versions

Released through a git tag X.Y.Z, which publishes X.Y.Z, X.Y and X (each also as -plugins) and moves latest. Changes and the contained versions are listed in the changelog⁠.

1.1.0 contains ansible 14.5.0, ansible-core 2.21.5, ansible-lint 26.10.1, Python 3.14.8 and Alpine 3.24.2. Python stays on 3.14 for now: ansible-core 2.21 does not run on Python 3.15.

⁠Python packages

• ansible - https://pypi.org/project/ansible/⁠
• ansible-lint - https://pypi.org/project/ansible-lint/⁠
• hvac - https://pypi.org/project/hvac/⁠
• botocore - https://pypi.org/project/botocore/⁠
• boto3 - https://pypi.org/project/boto3/⁠
• resolvelib - https://pypi.org/project/resolvelib/⁠

⁠Collections in -plugins

• community.general - https://galaxy.ansible.com/ui/repo/published/community/general/⁠
• ansible.posix - https://galaxy.ansible.com/ui/repo/published/ansible/posix/⁠
• ansible.netcommon - https://galaxy.ansible.com/ui/repo/published/ansible/netcommon/⁠
• community.hashi_vault - https://galaxy.ansible.com/community/hashi_vault⁠
• ansible-modules-hashivault - https://github.com/TerryHowe/ansible-modules-hashivault⁠

⁠Deprecated versions

These tags are no longer built. They are based on Alpine Linux releases that have reached their end of support and therefore no longer receive updates. The tags remain available in the registry, the Dockerfiles remain in the repository for reference.

• 3.20 3.20-plugins - alpine 3.20, end of support 2026-04-01
• 3.19 3.19-plugins - alpine 3.19, end of support 2025-11-01
• 3.18 3.18-plugins - alpine 3.18, end of support 2025-05-09

⁠Additional Alpine packages

Alpine packages are installed in the current image in the latest version - https://pkgs.alpinelinux.org/packages⁠

• sshpass
• openssh-client
• openssl
• rsync
• nano
• py-pip
• py3-setuptools
• git
• jq
• curl
• yq
• ca-certificates

⁠Examples

⁠Example usage for GitLab CI/CD

.gitlab-ci.yml

stages:
  - deployment

TestDeployment:
  stage: deployment
  image: epicsoft/ansible:1.1-plugins
  script:
    - ansible-playbook deployment.yml -i inventory.yml

⁠Example usage for Windows with WSL

A small workaround is necessary under WSL so that the correct permissions can be set.

docker run --rm -it --name ansible \
  -v $(pwd):/in:ro \
  epicsoft/ansible:latest-plugins \
    sh -c "mkdir /ansible \
      && rsync -a --quiet --exclude='.git' /in/ /ansible/ \
      && chmod -R 700 /ansible \
      && chmod -R 400 /ansible/secrets \
      && cd /ansible \
      && ansible-playbook deployment.yml -i inventory.yml"

⁠Reporting problems

Issues are welcome on GitLab⁠ and GitHub⁠. Please report a security problem as a confidential issue on GitLab instead of a public one.

⁠License

MIT⁠ — Copyright (c) 2020-2026 epicsoft LLC

The MIT license applies only to files created by epicsoft LLC. Third-party software in the images — ansible, ansible-core and ansible-lint (GPL-3.0-or-later), the other Python packages, the collections, the official python image and Alpine Linux — remains under its own licenses.