如何创建可跨多个Ansible项目导入复用的私有Ansible role

不需要重复复制代码、也不需要公开发布Role，常用的可行方案有3种，你可以根据自己的使用场景选择：

方案1：自定义本地Role搜索路径（适合个人本地开发场景） #

这是成本最低的方案，不需要额外服务，只需要修改Ansible基础配置即可：

• 把所有需要复用的私有Role统一存放到一个固定的本地目录，比如~/workspace/ansible-public-roles/
• 编辑用户级Ansible配置文件~/.ansible.cfg，在[defaults]配置段追加Role搜索路径：

[defaults]
roles_path = ~/workspace/ansible-public-roles:/etc/ansible/roles

配置完成后，本地所有Ansible项目执行Playbook时，都会自动到上述路径查找对应Role，完全不需要把Role复制到每个项目目录下。
注意：如果是多人协作场景，要确保所有协作者本地的公共Role目录内容、版本一致，避免出现执行差异。

方案2：私有Git仓库托管Role（适合小团队协作场景） #

你不需要把Role上传到公开的Ansible Galaxy，直接用私有Git仓库托管每个Role即可，支持版本锁定，权限完全可控：

• 为每个可复用的独立Role创建单独的私有Git仓库（可以用内网Gitlab、自建Gitea，或者私有Github/Gitee仓库），按Ansible Role规范维护目录结构
• 在需要使用该Role的Ansible项目根目录下创建requirements.yml，写入私有Role的仓库地址：

- src: git@your-internal-git-domain.com:devops/init-base-env.git
  scm: git
  version: v2.1.0 # 支持指定Tag、分支名、Commit Hash来锁定Role版本
  name: init-base-env

• 项目初始化时执行拉取命令即可把对应版本的Role下载到本地：ansible-galaxy install -r requirements.yml -p ./roles
  这个方案不需要额外搭建服务，只要团队成员有私有Git仓库的访问权限就能用，不同项目可以按需使用不同版本的Role，不会互相影响。

方案3：搭建内网私有Galaxy服务（适合中大型团队场景） #

如果团队维护的私有Role数量较多，需要统一做检索、权限管控、版本生命周期管理，可以在内网搭建私有的Ansible Galaxy服务，所有私有Role都上传到内部Galaxy，使用逻辑和公共Galaxy完全一致，只需要把拉取源配置为内网地址即可，所有数据都留在内网，不会出现代码泄露问题。

不推荐用软链接的方式跨项目引用Role，软链接在跨设备同步、CI/CD流水线环境中很容易出现路径失效问题，后期排查成本很高。

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