角色(Roles)
ansilbe自1.2版本引入的新特性,用于层次性、结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。要使用roles只需要在playbook中使用include指令即可。简单来讲,roles就是通过分别将变量、文件、任务、模板及处理器放置于单独的目录中,并可以便捷地include它们的一种机制。角色一般用于基于主机构建服务的场景中,但也可以是用于构建守护进程等场景中。
创建role的步骤:
1) 创建以roles命名的目录;
2) 在roles目录中分别创建以各角色名称命名的目录,如webservers等;
3) 在每个角色命名的目录中分别创建files、handlers、tasks、templates和vars目录;用不到的目录可以创建为空目录,也可以不创建;
4) 在playbook文件中,通过Includes调用各角色。
[root@centos6 ansible3]# mkdir -p roles/project/{tasks,files,vars,templates,handlers,default,meta} [root@centos6 ansible3]# tree . └── roles └── project ├── default ├── files ├── handlers ├── meta ├── tasks ├── templates └── vars 9 directories, 0 files
各目录作用介绍:
- 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文件
示例:接下来我们就简单的构建一个role
1)创建目录框架
[root@centos6 ansibletest]# mkdir -p roles/httpd/{tasks,templates,files,handlers} [root@centos6 ansibletest]# tree . └── roles └── httpd ├── files ├── handlers ├── tasks └── templates
2)编写任务
[root@centos6 ansibletest]# vim roles/httpd/tasks/yum.yml - name: install httpd yum: name=httpd state=present [root@centos6 ansibletest]# vim roles/httpd/tasks/copy.yml - name: copy config file template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf notify: restart service - name: copy index.html copy: src=index.html dest=/var/www/html/ owner=apache [root@centos6 ansibletest]# vim roles/httpd/tasks/start.yml - name: start httpd service: name=httpd state=started [root@centos6 ansibletest]# vim roles/httpd/tasks/main.yml - include: yum.yml - include: copy.yml - include: start.yml
3)配置模板和主页测试文件
[root@centos6 ansibletest]# cp /etc/httpd/conf/httpd.conf roles/httpd/templates/httpd.conf.j2 [root@centos6 ansibletest]# vim roles/httpd/templates/httpd.conf.j2 ServerName www.{{ ansible_fqdn }}.com:80 [root@centos6 ansibletest]# vim roles/httpd/files/index.html <h1>The is a test website.</h1>
4)定义handlers,使得配置文件模板改变后可以重启服务
[root@centos6 ansibletest]# vim roles/httpd/handlers/main.yml - name: restart service service: name=httpd state=restarted
[root@centos6 ansibletest]# tree . └── roles └── httpd ├── files │ └── index.html ├── handlers │ └── main.yml ├── tasks │ ├── copy.yml │ ├── main.yml │ ├── start.yml │ └── yum.yml └── templates └── httpd.conf.j2
5)角色已经编写完成,我们只需要在roles目录的同级目录下编写playbook,在playbook中直接使用角色所定义的任务
[root@centos6 ansibletest]# vim httpd.yml --- - hosts: websvrs remote_user: root roles: - httpd
6)大功告成,一个简单的角色就定义完成了,接下来我们去测试,go
[root@centos6 ansibletest]# ansible-playbook -C httpd.yml #先空跑一下,没有问题再实际执行
[root@centos6 ansibletest]# ansible-playbook httpd.yml
[root@centos6 ansibletest]# curl 192.168.0.11 <h1>The is a test website.</h1> [root@centos6 ansibletest]# curl 192.168.0.12 <h1>The is a test website.</h1>
# 和我们所预期的操作一样,那么以后可以向这个角色中添加更为丰富的功能