版本更新：

  • 系统版本：CentOS Linux release 7.8.2003 (Core)
  • ansible版本：2.9.10

role

参考：https://galaxy.ansible.com/home

角色是ansible自1.2版本引入的新特性，用于层次性、结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可。

简单来讲，roles就是通过分别将变量、文件、任务、模板及处理器放置于单独的目录中，并可以便捷地include它们的一种机制。角色一般用于基于主机构建服务的场景中，但也可以是用于构建守护进程等场景中。

目录结构

roles/project/ :项目名称,有以下子目录

  • files/ ：存放由copy或script模块等调用的文件
  • templates/：template模块查找所需要模板文件的目录
  • tasks/：定义task、role的基本元素，至少应该包含一个名为main.yml的文件；其它的文件需要在此文件中通过include进行包含
  • handlers/：至少应该包含一个名为main.yml的文件；其它的文件需要在此文件中通过include进行包含
  • vars/：定义变量，至少应该包含一个名为main.yml的文件；其它的文件需要在此文件中通过include进行包含
  • meta/：定义当前角色的特殊设定及其依赖关系,至少应该包含一个名为main.yml的文件，其它文件需在此文件中通过include进行包含
  • default/：设定默认变量时使用此目录中的main.yml文件，比vars的优先级低

创建role

步骤如下：

  1. 创建以roles命名的目录
  2. 在roles目录中分别创建以各角色名称命名的目录，如webservers等
  3. 在每个角色命名的目录中分别创建files、handlers、meta、tasks、templates和vars目录；用不到的目录可以创建为空目录，也可以不创建
  4. 在playbook文件中，调用各角色

调用角色

方法1：

1
2
3
4
5
6
7
---
- hosts: web_server
  remote_user: root
  roles:
    - mysql
    - memcached
    - nginx

方法2：

键role用于指定角色名称，后续的k/v用于传递变量给角色。

1
2
3
4
5
6
---
- hosts: all
  remote_user: root
  roles:
    - mysql
    - { role: nginx, username: nginx }

方法3：

还可基于条件测试实现角色调用。

1
2
3
4
5
---
- hosts: all
  remote_user: root
  roles:
    - { role: nginx, username: nginx, when: ansible_distribution_major_version == ‘7’  }

tag的使用

1
2
3
4
5
6
7
8
9
10
11
12
# nginx-role.yml
---
- hosts: web_server
  remote_user: root
  roles:
    - { role: nginx ,tags: [ 'nginx', 'web' ] ,when: ansible_distribution_major_version == "6“ }
    - { role: httpd ,tags: [ 'httpd', 'web' ]  }
    - { role: mysql ,tags: [ 'mysql', 'db' ] }
    - { role: mariadb ,tags: [ 'mariadb', 'db' ] }

ansible-playbook --tags="nginx,httpd,mysql" nginx-role.yml