wangdefa/ansible-playbook

Files

Wang Defa a6399d1bce 修复 Ansible stat 模块属性访问错误

- 修正 xxxigcc_update_pool_url.yaml 中的条件判断
- 将 log_dir_stat.isdir 修正为 log_dir_stat.stat.isdir
- 新增 stat 模块属性访问最佳实践文档
- 更新故障排除指南中的常见错误处理部分

2025-12-16 13:49:00 +08:00

1.6 KiB

Raw Permalink Blame History

Ansible 版本兼容性参考

版本兼容性矩阵

Ansible 版本	状态	主要变更	兼容性级别
2.9 及以下	不推荐	传统模块实现	低
2.10-2.13	部分兼容	模块命名空间变更	中
2.14+	推荐	废弃 `warn` 参数，模块规范化	高

关键变更详情

模块属性访问

Ansible stat 模块返回的是嵌套字典结构，访问属性时需要注意：

错误示例：log_dir_stat.isdir
正确示例：log_dir_stat.stat.isdir

原因：

stat 模块返回一个包含 stat 子字典的对象
必须通过 stat 子字典访问文件/目录属性
直接访问根对象属性会导致 'dict object' has no attribute 错误

`warn` 参数的移除

版本：Ansible 2.14
影响模块：command 和 shell
变更原因：简化模块接口，提高安全性

迁移指南

移除 warn: false
使用 ansible.builtin.shell 替代
调整执行策略

模块命名空间变更

从 command → ansible.legacy.command
推荐使用 ansible.builtin.shell

最佳实践

始终使用最新的 Ansible 版本
定期检查并更新 Playbook
使用 ansible_version 进行版本兼容性检查
谨慎访问模块返回的嵌套字典属性

参考资源