修复 Ansible 2.14+ 版本兼容性问题并更新文档
- 移除 xxxigcc_update_pool_url.yaml 中已废弃的 warn 参数 - 新增 Ansible 版本兼容性说明文档 - 更新 Pool URL 更新指南和架构文档 - 确保与 Ansible 2.14 及以上版本完全兼容
This commit is contained in:
39
llmdoc/reference/ansible-version-compatibility.md
Normal file
39
llmdoc/reference/ansible-version-compatibility.md
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
# Ansible 版本兼容性参考
|
||||||
|
|
||||||
|
## 版本兼容性矩阵
|
||||||
|
|
||||||
|
| Ansible 版本 | 状态 | 主要变更 | 兼容性级别 |
|
||||||
|
|------------|---------|-----------------------------|------------|
|
||||||
|
| 2.9 及以下 | 不推荐 | 传统模块实现 | 低 |
|
||||||
|
| 2.10-2.13 | 部分兼容 | 模块命名空间变更 | 中 |
|
||||||
|
| 2.14+ | 推荐 | 废弃 `warn` 参数,模块规范化 | 高 |
|
||||||
|
|
||||||
|
## 关键变更详情
|
||||||
|
|
||||||
|
### `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)
|
||||||
Reference in New Issue
Block a user