Ansible新手提问：如何在单个Role下管理多Task并规范引用？

1. 完善Nginx Role的任务入口（最佳实践第一步） #

Ansible Role的核心逻辑是通过tasks/main.yml作为任务的默认入口。你需要在roles/nginx/tasks/目录下创建main.yml文件，在其中导入所有子任务：

# roles/nginx/tasks/main.yml
- import_tasks: install.yml
- import_tasks: create_node_config.yml

配置完成后，Role会自动按顺序执行这两个子任务。

2. 在Playbook中调用整个Nginx Role #

如果需要执行Nginx Role下的所有任务，直接在Playbook的roles字段中声明即可，无需编写相对路径：

- name: 安装Nginx、Node和Verdeccia
  hosts: all
  remote_user: root
  vars:
    hostname: daz.com
  roles:
    - nginx

Ansible会自动从与Playbook同级的roles目录中识别Nginx Role，执行其中的所有任务。

3. 单独调用Role中的某个子任务（匹配nginx.install的需求） #

如果只想执行Role中的特定子任务（比如仅运行install.yml），可以使用import_role（静态导入，推荐用于无动态判断的场景）配合tasks_from参数实现：

- name: 安装Nginx、Node和Verdeccia
  hosts: all
  remote_user: root
  vars:
    hostname: daz.com
  tasks:
    - name: 执行Nginx安装任务
      import_role:
        name: nginx
        tasks_from: install.yml
    # 如需单独执行其他子任务，按相同格式添加
    - name: 生成Node配置文件
      import_role:
        name: nginx
        tasks_from: create_node_config.yml

如果需要根据变量动态判断是否执行任务，可以将import_role替换为include_role（动态导入）。

关键注意事项 #

• 避免使用相对路径include任务文件：这种写法依赖Playbook的存放位置，移植性差，不符合Ansible Role的最佳实践规范。
• 自定义Role搜索路径：如果你的Role不在Playbook同级的roles目录下，可以在ansible.cfg中通过roles_path配置自定义搜索路径，示例：

  [defaults]
  roles_path = ./roles:/opt/ansible/roles
  

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