Ansible多仓库共享角色找不到对应角色 是否需要配置ansible.cfg？

你的问题大概率是遗漏了两个核心配置/操作环节，对应的调整方案如下：

1. 先确认已执行角色拉取操作 #

requirements.yml只是Ansible的角色依赖声明文件，不会在运行playbook时自动拉取依赖。你需要在执行playbook之前，先运行以下命令拉取仓库W中定义的共享角色：

# 默认拉取到当前用户的~/.ansible/roles目录
ansible-galaxy install -r requirements.yml

# 如果希望把角色拉取到当前项目的./roles目录（更适合项目级隔离），加-p参数
ansible-galaxy install -r requirements.yml -p ./roles

如果拉取的是私有Git仓库，需要确认执行命令的账号配置了对应仓库的SSH访问权限，避免拉取失败导致角色目录不存在。

2. ansible.cfg 必改配置项 #

你需要在repo Y、repo Z的项目根目录下（或执行ansible命令的工作目录下）新增/修改ansible.cfg文件，在[defaults]块中配置roles_path，指定Ansible搜索角色的路径优先级，示例配置如下：

[defaults]
# 路径用冒号分隔，越靠前优先级越高
roles_path = ./roles:~/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles

配置完成后可以运行ansible-config dump | grep ROLES_PATH验证配置是否生效，确认你拉取角色的路径在搜索列表中。

3. 其他需要核对的配置 #

• 确认requirements.yml中name字段定义的角色名，和拉取后生成的角色目录名完全一致，Linux系统下大小写敏感，注意不要写错
• 如果使用相对路径配置roles_path，要确认执行ansible命令的工作目录和你预期的一致，避免相对路径解析错误
• 不要手动修改拉取后的角色目录名称，否则会和requirements.yml声明的名称不匹配，触发找不到角色的报错

内容的提问来源于stack exchange，提问作者MrAZ