使用 requirements.yml 安装 Role
锁定并获取依赖项
使用 requirements.yml 安装 Role 是 CoddyKit 上的免费 DevOps Bootcamp 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 DevOps Bootcamp 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。
不要手动逐个安装
逐个运行安装命令无法随着项目规模增长而持续使用。requirements.yml文件会列出所有依赖项，让整个项目能够一次性完成安装。
依赖项清单
可以将requirements.yml视为包清单：它准确声明了剧本运行所需的角色和集合。
在 roles 下列出角色
在文件中，roles键包含一个列表。每个条目都会通过 author.name 标识指定一个要从 Galaxy 获取的角色。
roles:
- name: geerlingguy.nginx同时列出集合
另一个collections键会通过 namespace.collection 名称列出集合，因此一个文件就能涵盖这两类内容。
collections:
- name: community.general固定版本
请始终添加版本，以确保安装结果可复现。没有版本号时，您可能会在团队成员的计算机上获取到更新但不兼容的版本。
roles:
- name: geerlingguy.nginx
version: "3.1.4"一次安装全部内容
使用-r将文件传递给 ansible-galaxy，它就会在一条命令中解析并安装所有列出的依赖项。
ansible-galaxy install -r requirements.yml集合需要单独运行命令
普通安装命令用于处理角色。对于集合，请使用collection install子命令，并配合相同的 -r 选项。
ansible-galaxy collection install -r requirements.yml也可以从 Git 获取，而不只是从 Galaxy 获取
角色条目可以使用srcGit URL，而不是 Galaxy 名称，这样您就能安装私有角色或未发布的角色。
roles:
- src: https://github.com/acme/role-app.git
version: main选择安装路径
添加-p可以将角色放入类似 roles/ 的项目本地文件夹，而不是全局路径，从而让每个项目保持自包含。
ansible-galaxy install -r requirements.yml -p roles/强制刷新
默认情况下会保留现有角色。升级固定版本时，请传入 --force，以便重新下载并覆盖这些角色。
ansible-galaxy install -r requirements.yml --force提交文件，而不是角色
将 requirements.yml 提交到 Git，但忽略已下载的角色文件夹。任何人都可以根据清单重建完全相同的集合。
快速检查
回想一下如何安装项目所依赖的所有内容。
回顾
在 requirements.yml 中列出角色和集合，固定版本，然后使用 ansible-galaxy -r 将它们全部安装。一个文件即可实现可复现的环境。📦
常见问题解答
「使用 requirements.yml 安装 Role」课时是免费的吗？
是的 — 「使用 requirements.yml 安装 Role」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 DevOps Bootcamp 课程的其余内容，请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。
「使用 requirements.yml 安装 Role」这节课中我会学到什么？
锁定并获取依赖项 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 DevOps Bootcamp 需要有经验吗？
无需任何先前经验。CoddyKit 上的 DevOps Bootcamp 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「使用 requirements.yml 安装 Role」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 DevOps Bootcamp 课中编写并运行代码吗？
能。每节 DevOps Bootcamp 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- Galaxy 中的 Role 与 Collection
- 使用 requirements.yml 安装 Role
- 使用 FQCN：namespace.collection.module
- 将您自己的 Role 发布到 Galaxy