### 关于 `ansible-galaxy install -r` 的用法 #### 命令概述 `ansible-galaxy install -r` 是用于通过指定的要求文件（requirements file）批量安装 Ansible Galaxy 中的角色或集合的命令。该命令允许用户定义一组角色或集合，并按照需求一次性完成安装操作。 --- #### 参数说明 以下是 `ansible-galaxy install -r` 的主要参数及其功能： | 参数 | 描述 | |------|------| | `-r`, `--role-file` | 指定一个 YAML 或 INI 格式的文件路径，其中列出了要安装的角色或集合的信息。此选项是必需的。 | | `-f`, `--force` | 即使目标角色已存在，也强制重新下载并覆盖现有版本。 | | `-p`, `--roles-path` | 定义角色的目标存储路径，默认情况下会保存在用户的默认角色目录中。 | | `--ignore-errors` | 如果某些角色无法成功安装，则忽略错误继续处理其他角色。 | --- #### 使用示例 ##### 示例 1：基本用法 假设有一个名为 `requirements.yml` 的文件，其内容如下： ```yaml --- - src: geerlingguy.redis version: "6.4.2" name: redis_role ``` 运行以下命令可以基于这个文件安装所需的角色： ```bash ansible-galaxy install -r requirements.yml ``` 这将从 Ansible Galaxy 下载 `geerlingguy.redis` 角色，并将其命名为 `redis_role`[^3]。 --- ##### 示例 2：带自定义路径的安装 如果希望将角色安装到特定目录而不是默认路径，可以通过 `-p` 参数实现。例如： ```bash ansible-galaxy install -r requirements.yml -p ./custom_roles/ ``` 这条命令会把所有角色安装到当前目录下的 `custom_roles/` 文件夹中。 --- ##### 示例 3：强制更新已有角色 当某个角色已经存在于本地但仍需更新至最新版时，可加入 `-f` 参数执行强制替换： ```bash ansible-galaxy install -r requirements.yml -f ``` --- ##### 示例 4：忽略部分失败情况 对于可能包含不可用资源的情况，可通过 `--ignore-errors` 防止整个过程因单个错误中断： ```bash ansible-galaxy install -r requirements.yml --ignore-errors ``` --- #### 注意事项 1. **要求文件格式** 要求文件通常采用 YAML 格式编写，每条记录应至少包含 `src` 字段来指明角色源地址；还可以附加 `version` 和 `name` 来进一步控制具体行为。 2. **依赖关系管理** 当前命令不会自动解析复杂的跨项目依赖链路，因此建议提前确认各组件间的兼容性配置[^1]。 3. **网络连接稳定性** 所有外部资源均需经互联网访问获取，请确保环境具备稳定连通条件以顺利完成任务。 --- ###