ansible 角色通过 meta/main.yml 文件中的 dependencies 字段配置依赖关系。在定义角色的元数据时,列出所需角色的名称或包含 role 键的字典对象即可实现自动加载。当主 playbook 引用该角色时,ansible 会先执行其声明的所有依赖角色,确保前置条件满足后再运行当前角色逻辑。

如何声明简单的角色名称依赖
最简单的依赖形式是直接指定字符串形式的角色名。这种方式适用于依赖角色不需要额外参数,且仅存在于默认搜索路径中的场景。Ansible 会按声明顺序依次查找并执行这些角色。
--- # meta/main.yml dependencies: - common-base - nginx-setup
上述配置中,common-base 和 nginx-setup 将被自动引入。执行顺序严格遵循列表中的先后次序。如果 common-base 尚未安装或不可见,任务将失败。这种写法简洁,但缺乏灵活性,无法传递变量或指定特定版本。
如何传递参数并指定来源
当依赖角色需要自定义变量,或者来自 Galaxy 集合、特定 URL 时,需使用字典格式声明。这允许你覆盖默认变量、指定角色来源甚至控制执行标签。通过 role 键指定名称,vars 键传入参数,source 键指向远程仓库。
---
# meta/main.yml
dependencies:
- role: webapp-config
vars:
app_port: 8080
db_host: localhost
- role: geerlingguy.mysql
source: https://galaxy.ansible.com
tags:
- database在此示例中,webapp-config 接收了 app_port 和 db_host 两个变量。而 geerlingguy.mysql 则从指定的 Galaxy 地址拉取,并仅在执行带有 database 标签时才触发。这种结构提供了对依赖行为的精细控制,适合复杂项目架构。
依赖角色间变量作用域如何影响结果
依赖角色中定义的变量默认具有全局作用域,会被主角色继承。若主角色也定义了同名变量,后执行的变量会覆盖先执行的值。这种机制可能导致意外行为,特别是在多个依赖角色共享同一变量名时。建议在主角色中使用 include_vars 或明确的作用域前缀来隔离数据。

















