cytopia/ansible

Ansible Docker镜像

基于Alpine的多阶段构建Docker镜像，提供Ansible的多种版本和功能变体，集成Mitogen以显著提升运行效率，支持amd64和arm64架构，适用于CI/CD环境及自动化运维场景。

镜像概述

本镜像为Ansible的容器化版本，基于轻量级Alpine Linux构建，通过多阶段构建减小镜像体积。提供多种功能变体，满足不同场景需求，并内置https://github.com/dw/mitogen%E7%AD%96%E7%95%A5%E6%8F%92%E4%BB%B6%EF%BC%8C%E5%8F%AF%E5%B0%86Ansible%E8%BF%90%E8%A1%8C%E9%80%9F%E5%BA%A6%E6%8F%90%E5%8D%87%E6%9C%80%E9%AB%98600%25%E3%80%82

核心特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多架构支持：兼容amd64和arm64架构
• 版本丰富：提供Ansible 2.8至最新版本的多种变体
• 功能扩展：包含基础版、工具版及云平台专用版（AWS、Azure等）
• 性能优化：集成Mitogen加速Ansible任务执行
• 持续更新：每日夜间构建，确保组件版本最新

可用架构

amd64, arm64

可用Docker镜像版本

Ansible基础版（Ansible base）

仅包含Ansible核心组件的最小化镜像，体积小巧。

Ansible工具版（Ansible tools）

在基础版基础上增加常用工具：bash、git、gpg、jq、ssh、dnspython及Mitogen策略插件。

Ansible Azure版

在工具版基础上增加Azure云平台相关工具和依赖。

Ansible AWS版

在工具版基础上增加AWS云平台工具：aws-cli、boto、boto3和botocore。

Ansible AWSK8s版

在AWS版基础上增加Kubernetes相关工具：openshift和kubectl。

其他变体

还提供包含kops的AWSKops版和包含helm的AWSHelm版，支持特定Kubernetes集群管理需求，具体版本可参考https://github.com/cytopia/docker-ansible%E3%80%82

时间点发布（Point in time releases）

以下Docker镜像标签为一次性构建，版本固定，适用于需要可重现构建的场景。

说明：<docker-tag>指上述滚动发布中的任意标签，<tag>指该仓库的Git标签版本。

使用场景

• CI/CD流水线：在持续集成/部署流程中执行Ansible剧本，确保环境一致性
• 自动化运维：容器化运行Ansible，避免在主机系统安装依赖
• 多版本测试：快速切换不同Ansible版本测试剧本兼容性
• 云平台管理：使用AWS/Azure专用版镜像管理云资源
• Kubernetes运维：通过AWSK8s/AWSHelm版管理K8s集群

使用方法示例

基本使用

查看Ansible版本：

bash
docker run --rm cytopia/ansible:latest ansible --version

运行Ansible剧本

挂载当前目录（包含剧本文件）并执行：

bash
docker run --rm -v $(pwd):/ansible cytopia/ansible:latest-tools ansible-playbook -i inventory.yml playbook.yml

使用Mitogen加速

在工具版镜像中已内置Mitogen，配置ansible.cfg启用：

ini
[defaults]
strategy = mitogen_linear

执行剧本：

bash
docker run --rm -v $(pwd):/ansible cytopia/ansible:latest-tools ansible-playbook -i inventory.yml playbook.yml

集成SSH密钥

如需通过SSH连接目标主机，挂载SSH密钥：

bash
docker run --rm \
  -v $(pwd):/ansible \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  cytopia/ansible:latest-tools \
  ansible-playbook -i inventory.yml playbook.yml

相关项目

更多CI工具Docker镜像可参考https://github.com/topics/awesome-ci%E9%A1%B9%E7%9B%AE%EF%BC%8C%E5%8C%85%E6%8B%ACansible-lint%E3%80%81terraform-docs%E3%80%81yamllint%E7%AD%89%E3%80%82

许可证

MIT许可证

Copyright (c) 2019 https://github.com/cytopia