一、roles 介绍
roles: 用于层次性、结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可
roles 优点:
1)模块中指令较少,方便编写
2)重复调用方便
3)排错方便
二、创建 roles 的目录结构
1、Roles各目录作用
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的优先级低
2、创建role的步骤
(1) 创建以 roles 命名的目录
(2) 在 roles 目录中分别创建以各角色名称命名的目录,如webservers等
(3) 在每个角色命名的目录中分别创建files、handlers、meta、tasks、templates和vars目录;用不到的目录可以创建为空目录,也可以不创建
(4) 在playbook文件中,调用各角色
#roles 目录结构 nginx-role.yml roles/ └── nginx ├── files │ └── main.yml ├── tasks │ ├── groupadd.yml │ ├── install.yml │ ├── main.yml │ ├── restart.yml │ └── useradd.yml └── vars └── main.yml
三、playbook 调用角色
1、调用角色
--- - hosts: websrvs remote_user: root roles: - mysql - memcached - nginx
2、键role 用于指定角色名称,后续的k/v用于传递变量给角色
--- - hosts: all remote_user: root roles: - mysql - { role: nginx, username: nginx }
3、基于条件测试实现角色调用
--- - hosts: all remote_user: root roles: - { role: nginx, username: nginx, when: ansible_distribution_major_version == ‘7’ }
4、roles 中 tags 使用
#nginx-role.yml --- - hosts: websrvs 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
四、使用 Galaxy 获取更多的 Role
查找网站:https://galaxy.ansible.com/
#在galaxy 上搜索共享的ROLE [root@localhost ~]# ansible-galaxy search #安装 galaxy 上共享的 ROLE ansible-galaxy install #列举已经通过 ansible-galaxy 工具安装的ROLE ansible-galaxy list #添加自定义查看路径 vim /etc/ansible/ansible.cfg #用于搜索角色的其他路径,以冒号分隔 roles_path = /etc/ansible/roles:/root/ansible/roles #创建一个ROLE 的空目录架构, 这样我们在开发一个ROLE的时候,就不需要手动创建目录了。 ansible-galaxy init --offline #创建了名字为nginx的空ROLE目录结构,默认在执行命令的目录生产。 ansible-galaxy init nginx