# Ansible 模块参考

## 核心模块列表

### 1. ansible.builtin.set_fact
- **用途**：动态构建和设置变量
- **示例**：`ansible.builtin.set_fact: install_command="..."`

### 2. ansible.builtin.debug
- **用途**：输出调试信息和变量
- **关键参数**：
  - `msg`：直接打印消息
  - `var`：打印变量值

### 3. ansible.builtin.get_url
- **用途**：从远程 URL 下载文件
- **关键参数**：
  - `url`：文件源地址
  - `dest`：目标路径
  - `mode`：文件权限

### 4. ansible.builtin.shell
- **用途**：执行复杂的 Shell 命令
- **注意事项**：
  - 比 `command` 模块更灵活
  - 支持管道和重定向

### 5. ansible.builtin.file
- **用途**：文件和目录管理
- **常用状态**：
  - `present`：确保文件存在
  - `absent`：确保文件不存在
  - `directory`：确保目录存在

## 使用场景映射

- 文件下载：`get_url`
- 动态参数：`set_fact`
- 命令执行：`shell`
- 日志记录：`debug`
- 文件清理：`file`

## 最佳实践提示

1. 优先使用专用模块
2. 谨慎使用 `shell` 模块
3. 始终关注安全性和幂等性