ju2wheels/ansible

docker-ansible

https://github.com/ju2wheels/docker-ansible 提供 https://hub.docker.com/r/ju2wheels/ansible/ Docker Hub镜像，针对多种Linux发行版，预装从PyPi安装的Ansible 1.x/2.x及核心模块依赖（使用Python 2.7），且安装在用户级别而非系统级别，以减少与系统Python包的冲突。

该镜像的目标是提供可用于单元测试（在本地容器运行Ansible模拟远程机器）和作为Ansible主机的容器。

可用Docker镜像标签

ju2wheels/ansible镜像标签遵循以下命名规则（各部分用-连接）：

1. Ansible主版本（如1.x或2.x，始终安装对应主版本的最新次版本）
2. Linux发行版名称
3. Linux发行版版本

注意：Alpine 3.3和3.4镜像无shadow-utils，因此从Alpine 3.5回退该工具，确保Ansible的user模块正常工作。

Dockerfile组织

每个镜像的Dockerfile命令按以下步骤组织：

1. 设置PATH及构建Python模块所需的环境变量
2. 系统更新（更新基础镜像中的所有包）
3. 补充仓库配置
4. 安装基础开发工具及Ansible工作所需的包
5. 安装构建Python模块（含Ansible）所需的开发库（后续会移除）
6. 从PyPi以用户级别（root）安装pip、Ansible及其他依赖
7. 卸载构建Python模块所需的开发库
8. 删除缓存和临时文件
9. 设置默认entrypoint为ansible-playbook

说明：选择用户级别安装而非虚拟环境，是因为部分Python模块只能通过发行版包安装，无法从PyPi获取。通过在系统级别安装Python 2.7及依赖，用户级别安装Ansible，可避免污染系统Python包或导致系统故障。

作为Ansible主机使用

默认情况下，所有镜像的entrypoint配置为ansible-playbook，用于单元测试。若要作为Ansible主机运行，需执行以下操作：

1. 覆盖entrypoint为合适的shell（如/bin/bash）
2. 挂载Ansible playbook目录为VOLUME
3. 设置ANSIBLE_CONFIG及可选的ANSIBLE_INVENTORY环境变量

CLI示例

bash
docker run --entrypoint /bin/bash                                   \
           --env ANSIBLE_CONFIG=/ansible-playbook/ansible.cfg       \
           --env ANSIBLE_INVENTORY=/ansible-playbook/inventory      \
           --volume '/home/user/ansible-playbook:/ansible-playbook' \
           -it ju2wheels/ansible:<tag> <ansible-playbook参数> <playbook.yml>

docker-compose示例

yaml
version: '2'
services:
  ansible_host:
    entrypoint: /bin/bash
    environment:
      ANSIBLE_CONFIG: /ansible-playbook/ansible.cfg
      ANSIBLE_INVENTORY: /ansible-playbook/inventory
    image: ju2wheels/ansible:<tag>
    tty: true
    volumes:
      # 若docker-compose.yml位于playbook根目录，可使用相对路径
      #- ./:/ansible-playbook
      - /home/user/ansible-playbook:/ansible-playbook

运行docker-compose：

bash
docker-compose run ansible_host
cd /ansible-playbook
ansible-playbook my-playbook.yml

作为Ansible角色单元测试使用

以下示例假设Ansible角色满足：

1. 符合ansible-galaxy init创建的Ansible 2.x角色结构
2. 测试目录包含ansible.cfg、inventory及指向主角色目录的软链接

Ansible 1.x单元测试示例（docker_test.yml）

yaml
---
- hosts: localhost
  tasks:
    - name: testrole dockerized unit test
      docker: >
        command=/ansible-playbook/tests/test.yml
        detach=false
        entrypoint=ansible-playbook
        env={"ANSIBLE_CONFIG": "/ansible-playbook/tests/ansible.cfg", "ANSIBLE_INVENTORY": "/ansible-playbook/tests/inventory", "ANSIBLE_NOCOLOR": 1}
        hostname=ansible_testrole_test
        image={{ item }}
        name=ansible_testrole_test
        pull=true
        restart_policy=false
        state=started
        tty=true
        volumes=["{{ playbook_dir }}/../:/ansible-playbook"]
      with_items:
        - ju2wheels/ansible:1.x-ubuntu-12.04
        - ju2wheels/ansible:1.x-ubuntu-14.04
        - ju2wheels/ansible:1.x-ubuntu-16.04

Ansible 2.x单元测试示例（docker_test.yml）

yaml
---
- hosts: localhost
  tasks:
    - name: testrole dockerized unit test
      docker_container:
        cleanup: true
        command: /ansible-playbook/tests/test.yml
        detach: false
        entrypoint: ansible-playbook
        env:
          ANSIBLE_CONFIG:    /ansible-playbook/tests/ansible.cfg
          ANSIBLE_INVENTORY: /ansible-playbook/tests/inventory
          ANSIBLE_NOCOLOR:   1
        hostname: ansible_testrole_test
        image: "{{ item }}"
        interactive: true
        name: ansible_testrole_test
        pull: true
        recreate: true
        restart_policy: false
        state: started
        tty: true
        volumes:
          - "{{ playbook_dir }}/../:/ansible-playbook"
      with_items:
        - ju2wheels/ansible:2.x-ubuntu-12.04
        - ju2wheels/ansible:2.x-ubuntu-14.04
        - ju2wheels/ansible:2.x-ubuntu-16.04

运行单元测试：

bash
cd testrole/tests
ansible-playbook docker_test.yml

注意：运行测试的主机需安装ansible、docker及对应Python模块（如docker-py）。

以其他用户运行Ansible

由于Ansible安装在用户级别，仅root用户可运行。若需添加其他用户，需复制root用户的HOME目录：

bash
useradd -m newuser
cp -ar /root/. /home/newuser/
chown -R newuser:newuser /home/newuser
echo 'export PATH=/home/newuser/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' >> /home/newuser/.bashrc

贡献

欢迎贡献新平台或更新Ansible模块依赖。提交PR前请先打开https://github.com/ju2wheels/docker-ansible/issues%E3%80%82

许可

GPLv2

作者

Julio Lajara <GH user at Gmail>