Ansible角色虽无内置测试框架,但可通过断言任务、Molecule集成测试、assert模块及CI流水线实现可验证、可重复、防回归的自动化检查。

Ansible 角色本身不直接支持“自动化测试用例”这种像单元测试(如 pytest)那样的内置测试框架,但可以通过组合标准实践和外部工具,在角色开发流程中实现**可验证、可重复、防回归的自动化检查**。关键不是写“测试用例”,而是构建**验证逻辑 + 执行机制 + 反馈闭环**。
用 tasks/main.yml 和 handlers 实现基础验证
在角色的 tasks/main.yml 末尾添加一组“断言型任务”,用于确认服务状态、配置生效、端口监听等关键结果:
- 检查服务是否运行:
- name: Verify Apache is running<br> ansible.builtin.systemd:<br> name: httpd<br> state: started<br> enabled: yes
- 确认配置语法正确:
- name: Validate Apache config syntax<br> ansible.builtin.command: apachectl configtest<br> changed_when: false<br> failed_when: "result.rc != 0"
- 验证端口是否监听:
- name: Wait for port 8080 to be open<br> ansible.builtin.wait_for:<br> port: 8080<br> host: "{{ ansible_host }}"<br> timeout: 30
用 Molecule 搭建角色级集成测试环境
Molecule 是 Ansible 社区广泛采用的角色测试工具,它自动创建临时容器(如 Docker)、部署角色、运行验证脚本(如 Testinfra 或 shell 命令),并清理环境:
- 初始化测试框架:
molecule init scenario --driver-name docker -r myrole - 在
molecule/default/converge.yml中调用你的角色:- name: Converge<br> hosts: all<br> roles:<br> - role: myrole
- 编写验证逻辑(如
molecule/default/verify.yml或 Python Testinfra):
检查文件是否存在、服务状态、进程名、HTTP 返回码等 - 一键运行全流程:
molecule test(会依次 create → converge → verify → destroy)
用 assert 模块做轻量级运行时断言
Ansible 自带 assert 模块,适合在 Playbook 执行中途校验变量或事实(facts)是否符合预期:
- 验证变量值:
- name: Assert PHP version is 8.2<br> ansible.builtin.assert:<br> that:<br> - php_version == "8.2"<br> msg: "PHP version mismatch, expected 8.2"
- 结合
setup模块收集的事实做判断:- name: Ensure SELinux is disabled or permissive<br> ansible.builtin.assert:<br> that:<br> - ansible_facts['selinux']['status'] in ['disabled', 'permissive']
配合 CI 流水线做持续验证
将测试嵌入 Git 仓库的 CI(如 GitHub Actions、GitLab CI)中,每次提交角色代码时自动触发:
- 安装 ansible + molecule + docker
- 运行
molecule lint(检查 YAML 格式、ansible-lint 规则) - 运行
molecule test(完整集成测试) - 失败即阻断合并,保障角色质量


















