# 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)