geerlingguy/docker-amazonlinux2-ansible

Amazon Linux 2 Ansible测试镜像

镜像概述和主要用途

Amazon Linux 2 Ansible测试镜像是一个基于Amazon Linux 2的Docker容器，专为Ansible剧本（playbook）和角色（role）的测试设计。该容器内置Ansible环境，提供隔离的运行环境，用于验证Ansible自动化逻辑在Amazon Linux 2系统上的兼容性和正确性。

核心功能和特性

镜像标签

• latest：轻量级基础镜像，包含最新稳定版Ansible，适用于Ansible剧本和角色的基本功能验证。
• testing：扩展功能镜像，在latest基础上额外集成测试工具套件，包括：
  • yamllint（YAML语法检查工具）
  • ansible-lint（Ansible语法及最佳实践检查工具）
  • flake8（Python代码风格检查工具）
  • testinfra（基础设施测试框架）
  • molecule（Ansible角色测试工具）

使用场景和适用范围

适用场景

• 本地或CI环境中验证Ansible剧本语法及执行逻辑
• 测试Ansible角色在Amazon Linux 2系统上的部署效果
• 结合CI/CD工具（如Jenkins、Travis）实现自动化测试流程

适用范围

• 仅限测试环境：用于开发阶段的隔离测试，非生产环境设计
• 不适用场景：生产环境部署、关键业务系统运行

使用方法和配置说明

构建镜像

如需本地构建镜像，执行以下步骤：

1. 安装Docker
2. 进入镜像构建目录：cd /path/to/dockerfile/directory
3. 执行构建命令：

   bash
   docker build -t amazonlinux2-ansible .
   

说明：通过切换代码分支（master分支构建基础版，testing分支构建带测试工具版），可生成对应功能的镜像。

拉取镜像

直接从Docker Hub拉取预构建镜像：

bash
# 拉取基础版（latest标签）
docker pull geerlingguy/docker-amazonlinux2-ansible:latest

# 拉取测试工具版（testing标签）
docker pull geerlingguy/docker-amazonlinux2-ansible:testing

运行容器

基础运行命令

bash
docker run --detach \
  --privileged \
  --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro \
  --name=ansible-test-container \
  geerlingguy/docker-amazonlinux2-ansible:latest

参数说明：

• --detach：后台运行容器
• --privileged：赋予容器特权模式（模拟系统级权限，支持服务管理）
• --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro：挂载cgroup文件系统（只读），确保系统服务正常运行
• --name：自定义容器名称（可选）

挂载本地Ansible角色（测试场景）

如需测试本地Ansible角色，添加角色目录挂载：

bash
docker run --detach \
  --privileged \
  --volume=/sys/fs/cgroup:/sys/fs/cgroup:ro \
  --volume=$(pwd):/etc/ansible/roles/role_under_test:ro \
  geerlingguy/docker-amazonlinux2-ansible:latest

说明：$(pwd)替换为本地Ansible角色的实际路径，ro表示只读挂载。

在容器内使用Ansible

1. 查看Ansible版本：

   bash
   docker exec --tty [容器ID/名称] env TERM=xterm ansible --version
   

2. 检查剧本语法：

   bash
   docker exec --tty [容器ID/名称] env TERM=xterm ansible-playbook /path/to/playbook.yml --syntax-check
   

3. 执行Ansible剧本：

   bash
   docker exec --tty [容器ID/名称] env TERM=xterm ansible-playbook /path/to/playbook.yml
   

注意事项

• 安全提示：本镜像为测试用途设计，配置和权限设置可能不符合生产环境安全标准，切勿用于生产系统。
• 风险声明：在生产环境或关键系统中使用此镜像需自行承担风险。
• 使用建议：推荐作为CI/CD流程的一部分，与自动化测试工具结合使用，确保Ansible代码质量。

作者

由Jeff Geerling于2018年创建，其代表作包括《Ansible for DevOps》。