philm/ansible_playbook

Ansible Playbook Docker镜像

该镜像通过容器化方式提供ansible-playbook命令运行环境，用于执行外部挂载的Ansible Playbooks，避免本地环境依赖冲突。

核心功能

• 执行外部挂载目录中的Ansible Playbooks
• 支持SSH密钥对挂载，实现与外部机器交互
• 集成Ansible Vault，支持加密/解密操作
• 可与Ansible Target测试容器联动，验证Playbook正确性
• 提供Docker Compose配置示例，简化多容器测试流程

使用场景

• 自动化部署应用或系统配置管理
• 隔离环境中测试Ansible Playbooks
• 团队统一Ansible执行环境，避免版本差异问题

配置说明

基础使用

将本地Playbooks目录挂载到容器，执行指定Playbook：

docker run --rm -it -v 本地Playbooks路径:/ansible/playbooks philm/ansible_playbook 目标Playbook文件名

示例（符合Ansible最佳实践结构）：

docker run --rm -it -v $(pwd):/ansible/playbooks philm/ansible_playbook site.yml

Playbook变量可直接追加在文件名后。

SSH密钥配置

与外部机器交互时，需挂载SSH密钥对：

docker run --rm -it \
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
    -v ~/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub \
    -v $(pwd):/ansible/playbooks \
    philm/ansible_playbook site.yml

Ansible Vault配置

解密Vault加密数据：

1. 交互式输入密码：

docker run --rm -it -v $(pwd):/ansible/playbooks philm/ansible_playbook site.yml --ask-vault-pass

2. 挂载密码文件：

docker run --rm -it -v $(pwd):/ansible/playbooks \
    -v ~/.vault_pass.txt:/root/.vault_pass.txt \
    philm/ansible_playbook site.yml --vault-password-file /root/.vault_pass.txt

使用ansible-vault命令需指定entrypoint：

docker run --rm -it -v $(pwd):/ansible/playbooks --entrypoint ansible-vault philm/ansible_playbook encrypt 文件名

测试Playbooks - Ansible Target容器

与测试容器联动验证Playbook：

1. 编写inventory文件：

[test]
ansible_target

2. Playbook指定目标主机：

- hosts: test
  remote_user: ubuntu
  tasks:
  ... 任务内容 ...

3. 链接容器执行测试：

docker run --rm -it \
    --link ansible_target \
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
    -v ~/.ssh/id_rsa.pub:/root/.ssh/id_rsa.pub \
    -v $(pwd):/ansible/playbooks \
    philm/ansible_playbook tests.yml -i inventory

Docker Compose配置

使用Compose简化测试流程： 示例命令：

docker-compose run --rm test remote.yml -i inventory

重新创建测试容器：

docker rm -v -f ansible_target

注：Compose后续版本将支持自动移除服务（参考https://github.com/docker/compose/issues/2774%EF%BC%89%E3%80%82

特权操作

Compose文件中privileged: true选项可模拟VM环境，支持安装Docker引擎等操作（参考Docker文档）。