oowy/ansible

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

3. 生产环境建议

• 指定具体版本：避免使用 latest 标签，建议显式指定版本（如 2.18.5），确保环境一致性
• 挂载敏感文件：SSH 私钥、云厂商凭证等敏感信息通过文件挂载（-v）传入，避免硬编码到镜像
• 限制容器权限：运行容器时使用非 root 用户（可通过 --user 参数指定），降低安全风险

六、社区支持

• 维护者：Oowy team
• 问题反馈：Ansible 核心功能问题请在 https://github.com/ansible/ansible 提交 issue
• 获取帮助：可通过 Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow 寻求支持