用途:面向已有 Ansible 代码的校验与调试,而非生成新代码。适用于 playbook、role、collection、inventory 的语法检查、lint、试运行、安全审计与错误排查。
主要能力:YAML 语法校验(yamllint、ansible-playbook --syntax-check);ansible-lint 最佳实践检查;check 模式试运行;对含 molecule/ 的 role 自动尝试 Molecule 测试;Checkov 安全扫描与硬编码密钥检测;非 FQCN 模块检测;自定义模块/collection 的版本感知文档查询。
使用方式:先运行 bash scripts/setup_tools.sh 做预检。常用命令:bash scripts/validate_playbook.sh <playbook.yml>、bash scripts/validate_role.sh <role-dir>、bash scripts/test_role.sh <role-dir> [scenario]、bash scripts/validate_playbook_security.sh <path>、bash scripts/validate_role_security.sh <path>、bash scripts/scan_secrets.sh <path>、bash scripts/check_fqcn.sh、bash scripts/extract_ansible_info_wrapper.sh <path>。也可直接使用 ansible-playbook --syntax-check、ansible-lint、checkov -d . --framework ansible 等命令。
限制:Molecule 需 docker 或 podman 运行时,缺失时标记 BLOCKED 并继续其余步骤;工具缺失时脚本会尝试临时环境引导,失败则跳过对应阶段。BLOCKED 表示环境限制,FAIL 表示代码或测试失败。具体支持范围与版本细节以实际环境为准,资料未提供更多平台与收费信息。