Ansibleroles该怎么使用

你指的应该是 Ansible Roles（角色） 的使用方法。下面我用清晰、实用的方式给你讲一下。

一、什么是 Ansible Role

Role（角色） 是 Ansible 中用于组织和复用任务的一种方式。
它把 playbook、变量、文件、模板、处理器等按固定目录结构分开，便于维护和复用。

一句话：

Role = 结构化的“功能模块”

二、Role 的标准目录结构

roles/
└── nginx/
    ├── tasks/
    │   └── main.yml
    ├── handlers/
    │   └── main.yml
    ├── templates/
    │   └── nginx.conf.j2
    ├── files/
    │   └── index.html
    ├── vars/
    │   └── main.yml
    ├── defaults/
    │   └── main.yml
    ├── meta/
    │   └── main.yml
    └── README.md

各目录作用

三、创建一个 Role（推荐方式）

ansible-galaxy init nginx

会生成完整目录结构。

四、在 Playbook 中使用 Role

示例目录

site.yml
roles/nginx/

site.yml

---
- hosts: webservers
  become: yes
  roles:
    - nginx

运行：

ansible-playbook site.yml

五、Role 中 tasks 示例

roles/nginx/tasks/main.yml

---
- name: Install nginx
  apt:
    name: nginx
    state: present

- name: Copy config
  template:
    src: nginx.conf.j2
    dest: /etc/nginx/nginx.conf
  notify: Restart nginx

六、Handlers 示例

roles/nginx/handlers/main.yml

---
- name: Restart nginx
  service:
    name: nginx
    state: restarted

七、传参给 Role（推荐方式）

roles:
  - role: nginx
    vars:
      nginx_port: 8080

或在 defaults/main.yml 中定义默认值。

八、Role 依赖（meta）

roles/nginx/meta/main.yml

dependencies:
  - role: common

九、最佳实践建议

✅ 一个 Role 只做一件事
✅ 使用 defaults 提供默认值
✅ 使用 vars 覆盖关键配置
✅ Role 名要语义化（nginx / docker / mysql）
✅ 复杂项目用 roles + playbook 分层

十、常见误区

❌ 把 Role 写成“大杂烩”
❌ 在 Role 里写死 IP
❌ 不使用 handlers
❌ Role 和 playbook 混在一起

如果你愿意，我可以：

• 给你一个 完整 nginx Role 示例
• 讲 Role vs Playbook 的区别
• 教你 从零搭建 Ansible 项目结构

你更想了解哪一块？