Wang Defa
a6399d1bce
- 修正 xxxigcc_update_pool_url.yaml 中的条件判断 - 将 log_dir_stat.isdir 修正为 log_dir_stat.stat.isdir - 新增 stat 模块属性访问最佳实践文档 - 更新故障排除指南中的常见错误处理部分
52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
# 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`
|
||
- **变更原因**：简化模块接口，提高安全性
|
||
|
||
#### 迁移指南
|
||
|
||
1. 移除 `warn: false`
|
||
2. 使用 `ansible.builtin.shell` 替代
|
||
3. 调整执行策略
|
||
|
||
### 模块命名空间变更
|
||
|
||
- 从 `command` → `ansible.legacy.command`
|
||
- 推荐使用 `ansible.builtin.shell`
|
||
|
||
## 最佳实践
|
||
|
||
- 始终使用最新的 Ansible 版本
|
||
- 定期检查并更新 Playbook
|
||
- 使用 `ansible_version` 进行版本兼容性检查
|
||
- 谨慎访问模块返回的嵌套字典属性
|
||
|
||
## 参考资源
|
||
|
||
- [Ansible 官方版本发行说明](https://docs.ansible.com/ansible/latest/release_notes/index.html)
|
||
- [Ansible 模块迁移指南](https://docs.ansible.com/ansible/latest/dev_guide/module_lifecycle.html) |