ansible-lint

ansible-lint Playbook 检查

补充说明

ansible-lint 检查 Ansible playbook 和 role 的语法、风格、幂等性和安全实践，能在执行前发现常见错误。适合 CI 和本地 pre-commit。

支持内置规则和自定义规则，输出可读文本或 SARIF。

常用示例

安装：

pip install ansible-lint
ansible-lint --version

扫描：

ansible-lint site.yml
ansible-lint roles/
ansible-lint --format sarif > ansible.sarif

跳过规则：

ansible-lint -x command-instead-of-module site.yml

配置 .ansible-lint：

---
exclude_paths:
  - .cache/
  - molecule/
warn_list:
  - experimental

易错点与排错

• 规则 ID 随版本变化，升级后 CI 突然失败。
• 跳过规则没有注释，长期积累风险。
• 只检查 playbook，不检查 role 和 inventory。
• 与 ansible-playbook --syntax-check 混淆，后者只查语法。
• 依赖的 collection 未安装，检查时报解析错误。
• 忽略 molecule/ 等测试目录，避免重复检查。
• 自动修复 (--fix) 修改了业务逻辑，提交前要 review。