Ansible Docker 镜像文档

镜像概述和主要用途

Ansible Docker 镜像旨在提供一致的 Ansible 运行环境，适用于本地机器或 CI/CD 系统。通过容器化 Ansible，可确保在不同环境中运行 Ansible 时的一致性，避免因依赖差异导致的问题。

查看 变更日志 了解最新更新。

!Docker Pulls !Docker Image Size (tag)

核心功能和特性

• 多版本支持：涵盖 Ansible 2.9 至 2.18 等多个版本，包括当前维护版本和旧版本（未维护）。
• 多基础镜像：支持 Alpine、Ubuntu、Debian、Rocky Linux 等多种基础操作系统。
• 性能优化：内置 Mitogen，可显著提升 Ansible 剧本执行效率。
• 架构兼容性：支持 linux/arm64（适用于 Macbook 和 AWS Graviton）及 linux/arm/v7/linux/arm/v6（适用于树莓派，实验性）。
• 工具集成：包含 ansible-core、ansible、ansible-lint 等核心工具。
• 不可变镜像：提供按 "Ansible版本-基础操作系统版本" 命名的不可变镜像，确保环境一致性。

使用场景和适用范围

• 本地开发：在本地环境中快速启动标准化的 Ansible 环境，无需手动配置依赖。
• CI/CD 流水线：作为 CI/CD 流程的一部分，自动化执行 Ansible 剧本、 lint 检查等任务。
• 多版本测试：在不同 Ansible 版本下测试剧本兼容性。
• 老旧系统支持：提供旧版本 Ansible（如 2.9、2.10）以支持遗留工作负载。

支持的版本与标签

当前 Ansible 核心版本

容器中运行的最新 Ansible Core 版本如下：

• Ansible 2.13: 2.13.13
• Ansible 2.14: 2.14.18
• Ansible 2.15: 2.15.13
• Ansible 2.16: 2.16.14
• Ansible 2.17: 2.17.12
• Ansible 2.18: 2.18.6

旧版本（如 2.9、2.10、2.11、2.12）已归入未维护部分，仍可使用但不再更新。更多版本信息参见 Ansible 发布文档 和 Ansible-core 与 Python 兼容性。

不可变镜像

提供多个不可变镜像，标签格式为 Ansible版本-基础操作系统版本。具体版本可在 Docker Hub 标签页 中查询。

Ansible Core 版本（2.13、2.14、2.15、2.16、2.17、2.18）

包含以下组件：

• ansible-core (<[***]>)
• ansible (<[***]>)
• ansible-lint (<[***]>)

ARM 架构支持

• linux/arm64（适用于 Macbook 和 AWS Graviton）：支持 latest 和 alpine 标签。
• linux/arm/v7 和 linux/arm/v6（适用于树莓派）：支持 arm 标签（实验性）。

旧版本（未维护）

以下版本不再更新，但仍可用于遗留工作负载：

• Ansible 2.12 (2.12.10)：包含 ansible-core + ansible，需 Python ≥3.8。
• Ansible 2.11 (2.11.12)：包含 ansible-core + ansible，需 Python 3。
• Ansible 2.10 (2.10.17)：包含 ansible-base。
• Ansible 2.9 (2.9.27)：包含 ansible。

所有旧版本均包含 ansible-lint。具体标签及 Dockerfile 链接可参考 原文档旧版本表格。

配置说明

使用 Mitogen 提升性能

所有镜像均预装 Mitogen 以提升剧本执行效率。使用前需配置 ansible.cfg，步骤如下：

1. 查找 Mitogen 路径：在容器中执行以下命令获取 ansible_mitogen 插件路径：

   your_container="ansible:latest"  # 替换为实际使用的镜像标签
   docker run --rm -it "willhallonline/${your_container}" /bin/sh -c "find / -type d | grep 'ansible_mitogen/plugins' | sort | head -n 1"
   

2. 配置 ansible.cfg：在本地 ansible.cfg 中添加以下内容（路径替换为上一步结果）：

   [defaults]
   strategy_plugins = /usr/local/lib/python3.x/site-packages/ansible_mitogen/plugins/  # 替换为实际路径
   strategy = mitogen_linear
   

详细使用方法

基本运行

启动容器并进入交互式 shell：

docker run --rm -it willhallonline/ansible:latest /bin/sh

--rm：退出后自动删除容器；-it：启用交互式终端。

挂载目录与 SSH 密钥

挂载本地 Ansible 项目目录和 SSH 密钥，以执行远程操作：

docker run --rm -it \
  -v $(pwd):/ansible \                # 挂载当前目录到容器内 /ansible
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa  # 挂载本地 SSH 私钥到容器
  --workdir=/ansible \                # 设置工作目录为 /ansible
  willhallonline/ansible:latest /bin/sh

确保 SSH 密钥权限正确（容器内 /root/.ssh/id_rsa 权限需为 600）。

直接执行命令

直接在容器中执行 Ansible 命令（如运行剧本）：

docker run --rm -it \
  -v $(pwd):/ansible \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
  --workdir=/ansible \
  willhallonline/ansible:latest \
  ansible-playbook -i inventory.yml playbook.yml  # 替换为实际命令

Bash 别名设置

为常用命令创建 Bash 别名（添加到 ~/.bashrc 或 ~/.zshrc）：

# 交互式 shell 别名
alias docker-ansible-cli='docker run --rm -it \
  -v $(pwd):/ansible \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
  --workdir=/ansible \
  willhallonline/ansible:latest /bin/sh'

# 直接执行命令别名
alias docker-ansible='docker run --rm -it \
  -v $(pwd):/ansible \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
  --workdir=/ansible \
  willhallonline/ansible:latest'

使用示例：

# 进入交互式 shell
docker-ansible-cli

# 直接运行剧本
docker-ansible ansible-playbook playbook.yml

维护者

由 Will Hall 开发和维护。

Docker Hub 镜像地址