Ansible Docker 镜像文档

一、镜像概述

Ansible 是一款开源的配置管理和自动化工具，支持通过 YAML 语言描述任务，实现基础设施编排（如应用部署、云资源配置、跨服务编排等）。本 Docker 镜像基于轻量级 Alpine Linux 构建，集成了 ansible-core 和 ansible-lint（版本号与镜像版本一致），旨在提供高效的容器化 Ansible 运行环境，简化自动化任务的执行与管理。

二、核心功能与特性

1. Ansible 核心特性

无代理架构：仅需目标主机安装 SSH 和 Python，无需额外部署代理软件
声明式配置：使用 YAML 格式定义自动化任务，语法简洁易懂
多环境支持：可跨物理机、虚拟机、云环境（AWS、Azure、GCP 等）编排基础设施
丰富的模块生态：内置数百个***模块，支持系统配置、应用部署、用户管理等场景
社区驱动：活跃社区提供大量现成的 Playbook、Role 和自定义模块

2. 镜像特性

轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
版本对齐：每个镜像版本包含对应版本的 ansible-core 和 ansible-lint
多架构支持：兼容 amd64 和 arm64v8 架构
灵活部署：可直接运行 Ansible 子命令，或作为基础镜像构建自定义环境

三、使用场景

服务器配置管理：批量配置操作系统参数、安装软件、管理服务
应用部署自动化：跨环境（开发/测试/生产）一致化部署应用
云资源编排：通过云厂商模块（如 AWS、Azure）自动化创建和管理资源
系统维护任务：自动化用户管理、日志清理、系统更新等日常操作
多节点协调：编排复杂的多服务架构（如微服务、数据库集群）部署流程

四、支持的标签与架构

1. 支持的标签

镜像标签与 Ansible 版本对应，基于不同 Alpine Linux 版本构建：

基于 Alpine Linux 3.20

latest（建议生产环境使用具体版本）
2.18.5, 2.18.4, 2.18.3, 2.18.2, 2.18.1, 2.18.0

基于 Alpine Linux 3.19

2.17.7, 2.17.6, 2.17.5, 2.17.4, 2.17.3, 2.17.2, 2.17.1, 2.17.0

基于 Alpine Linux 3.18

2.16.8, 2.16.7, 2.16.6, 2.16.5, 2.16.4, 2.16.3, 2.16.2, 2.16.1, 2.16.0
2.15.8, 2.15.7, 2.15.6, 2.15.5, 2.15.4, 2.15.3, 2.15.2, 2.15.1, 2.15.0
2.14.11, 2.13.13, 2.12.10

2. 支持的架构

amd64
arm64v8

五、使用方法与配置说明

1. 基本使用

通过 docker run 命令直接执行 Ansible 子命令，格式为：
docker run --rm [选项] oowy/ansible:[版本] [ansible子命令] [参数]

示例 1：查看 Ansible 版本

bash
docker run --rm oowy/ansible:2.18.5 ansible --version

示例 2：运行 Playbook

假设本地有 Ansible 配置文件（ansible.cfg）、 inventory 文件（inventory.ini）和 Playbook（site.yml），可通过挂载本地目录执行：

bash
docker run --rm \
  -v $(pwd):/ansible \          # 挂载本地目录到容器内/ansible
  -w /ansible \                 # 设置工作目录为/ansible
  oowy/ansible:2.18.5 \
  ansible-playbook -i inventory.ini site.yml

2. 配置说明

挂载配置文件

Ansible 依赖配置文件（如 ansible.cfg）、inventory 文件和 Playbook。需通过 -v 参数将本地目录挂载到容器内，确保 Ansible 可访问这些文件：

bash
docker run --rm -v /path/to/local/ansible:/ansible -w /ansible oowy/ansible:2.18.5 ansible --version

环境变量

可通过 -e 参数传递环境变量，用于配置 Ansible 运行时参数（如认证信息、代理设置等）：

bash
docker run --rm \
  -e ANSIBLE_REMOTE_USER=admin \  # 远程主机用户名
  -e ANSIBLE_PRIVATE_KEY_FILE=/ansible/id_rsa \  # SSH 私钥路径（需挂载对应文件）
  -v /path/to/local/ansible:/ansible \
  -w /ansible \
  oowy/ansible:2.18.5 \
  ansible-playbook site.yml

自定义基础镜像

如需预置依赖或配置，可基于本镜像构建自定义镜像（示例 Dockerfile）：

dockerfile
FROM oowy/ansible:2.18.5

# 安装额外依赖（如 AWS CLI 用于云资源管理）
RUN apk add --no-cache aws-cli

# 预置 Ansible 配置
COPY ansible.cfg /etc/ansible/ansible.cfg

# 设置默认工作目录
WORKDIR /ansible