docker-ansible 镜像文档

镜像概述

docker-ansible是一个集成了Ansible及其官方集合，同时包含rsync、git和openssh-client等常用工具的Docker镜像。该镜像旨在提供一个开箱即用的自动化运维环境，简化Ansible相关任务的执行流程，无需在本地系统单独配置依赖工具链。

核心功能与特性

• Ansible集成：包含Ansible核心组件及其官方集合，支持自动化部署、配置管理、应用编排等运维任务。
• 文件同步工具：内置rsync，支持高效的本地及远程文件同步与备份。
• 版本控制支持：集成git客户端，可直接拉取代码仓库中的Ansible剧本或配置文件。
• 远程连接能力：包含openssh-client，支持通过SSH协议连接远程服务器执行Ansible任务。

适用场景

• 快速构建临时Ansible运行环境，避免本地系统依赖冲突。
• 远程服务器集群的批量配置管理与软件部署。
• CI/CD流水线中集成Ansible自动化步骤，实现部署流程标准化。
• 需要同时使用版本控制（git）、文件同步（rsync）和远程执行（SSH）的复合运维任务。

使用方法与配置说明

基本使用

通过以下命令启动容器并验证Ansible版本：

docker run --rm -it docker-ansible ansible --version

执行Ansible Playbook

挂载本地工作目录至容器，执行指定的Ansible Playbook：

# 将当前目录挂载至容器的/workspace目录，并在该目录下执行playbook
docker run --rm -v $(pwd):/workspace -w /workspace docker-ansible ansible-playbook your-playbook.yml

结合SSH密钥访问远程主机

挂载本地SSH密钥至容器，实现无密码SSH连接远程服务器：

# 挂载SSH密钥目录和工作目录，执行针对inventory.yml中主机的playbook
docker run --rm \
  -v ~/.ssh:/root/.ssh \
  -v $(pwd):/workspace \
  -w /workspace \
  docker-ansible \
  ansible-playbook -i inventory.yml your-playbook.yml

拉取Git仓库并执行任务

利用容器内的git工具拉取远程代码仓库，直接运行仓库中的Ansible剧本：

docker run --rm -v $(pwd):/workspace -w /workspace docker-ansible sh -c "
  git clone [***] && \
  cd your-ansible-repo && \
  ansible-playbook deploy-production.yml
"

注意事项

• 挂载本地目录时需确保目录权限正确，避免因权限不足导致文件读写失败。
• 敏感信息（如Ansible Vault密码、SSH密钥）建议通过环境变量或加密文件传入，避免明文暴露。
• 如需持久化Ansible配置或缓存，可挂载~/.ansible目录至容器：-v ~/.ansible:/root/.ansible。