如何在Ansible中按子目录组织roles并实现多目录加载调用

前提说明 #

Ansible原生支持多目录加载roles，完全可以实现你需要的roles/server/nginx、roles/devpc/linuxlaptop这类分层存放结构，不需要额外插件支持。 #

步骤1：搭建分层目录结构 #

首先按照你的分类需求创建对应的目录树，参考示例如下：

Ansible项目根目录/
├── ansible.cfg       # 项目配置文件
├── playbooks/        # 剧本存放目录
│   ├── deploy_web.yml
│   └── init_devpc.yml
└── roles/            # 角色根目录
    ├── server/       # 服务端角色分类目录
    │   ├── nginx/
    │   │   ├── tasks/
    │   │   ├── handlers/
    │   │   └── defaults/
    │   └── mysql/
    └── devpc/        # 开发端设备角色分类目录
        ├── linuxlaptop/
        │   ├── tasks/
        │   └── files/
        └── macbook/

步骤2：配置roles加载路径 #

修改项目根目录下的ansible.cfg，调整roles_path配置，有两种常用方案可选：

方案A：按分类目录配置（调用时直接写角色名） #

把所有分类子目录都加到roles_path中，Ansible会自动遍历这些目录找对应的角色：

[defaults]
roles_path = ./roles/server:./roles/devpc

playbook调用示例：

---
- name: 部署Nginx服务
  hosts: web_cluster
  roles:
    - nginx # 自动匹配roles/server/nginx目录

注意：该方案如果不同分类下有重名角色，会优先加载roles_path里排在前面的目录中的角色，容易出现冲突。

方案B：仅配置角色根目录（调用时带分类路径，推荐） #

只把角色根目录加到roles_path，调用角色时携带分类前缀，结构更清晰，无重名冲突问题：

[defaults]
roles_path = ./roles

playbook调用示例：

---
- name: 初始化Linux开发笔记本环境
  hosts: dev_laptops
  roles:
    - devpc/linuxlaptop # 精准匹配roles/devpc/linuxlaptop目录

步骤3：验证配置有效性 #

执行以下命令查看当前生效的roles加载路径：
ansible-config dump | grep DEFAULT_ROLES_PATH
执行以下命令列出所有Ansible可识别的角色及对应路径，确认你的分层角色正常被加载：
ansible-galaxy list #

补充：ansible-galaxy安装角色到指定分层目录 #

如果需要从Ansible Galaxy安装角色直接存入对应分类目录，可以用-p参数指定目标路径：
ansible-galaxy install geerlingguy.nginx -p ./roles/server
安装完成后会自动生成./roles/server/nginx目录，和自定义角色结构完全一致。 #

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