Ansible 的角色定义及调用
概述： 本章是上篇ansible的后续，将主要介绍ansible中角色的定义和调用，内容如下：[*]角色目录的定义方法
[*]在playbook中调用角色的方法；
[*]示例： ·定义nginx角色并调用； ·定义memcached角色并调用； ·定义mysql角色并调用；
==========================================================================角色：roles---以特定的层级目录结构进行组织的tasks、variables、handlers、templates、files（依赖的文件）等；★角色目录的定义：role_name/（以角色名命名的目录）
[*]files/： 存储由copy或script等模块调用的文件；
[*]tasks/： 此目录中至少应该有一个名为main.yml的文件，用于定义各task；其它的文件需要由main.yml进行“包含”调用；
[*]handlers/： 此目录中至少应该有一个名为main.yml的文件，用于定义各handler；其它的文件需要由main.yml进行“包含”调用；
[*]vars/： 此目录中至少应该有一个名为main.yml的文件，用于定义各variable；其它的文件需要由main.yml进行“包含”调用；
[*]templates/： 存储由template模块调用的模板文本；
[*]meta/： 此目录中至少应该有一个名为main.yml的文件，定义当前角色的特殊设定及其依赖关系；其它的文件需要由main.yml进行“包含”调用；
[*]default/： 此目录中至少应该有一个名为main.yml的文件，用于设定默认变量；
★在playbook中调用角色的方法：
演示：
创建角色，并在playbook中调用角色 在/etc/ansible/roles（路径不唯一）中定义role_name以及各role_name中的模块文件如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# mkdir ./{nginx,memcached，httpd,mysql}/{files,templates,vars,handlers,meta,default,tasks} -pv
# ls
httpdmemcachedmysqlnginx
# tree
.
├── httpd
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
├── memcached
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
├── mysql
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
└── nginx
├── default
├── files
├── handlers
├── meta
├── tasks
├── templates
└── vars
定义nginx角色，并调用： 1.现在我们首先定义nginx角色的任务目录，其中会调用到一些其他的模块，它会自动到对应的模块中获取文件内容，如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# vim nginx/tasks/main.yml
- name: copy nginx package to remote host # 调用files模块
copy: src=nginx-1.10.0-1.el7.ngx.x86_64.rpmdest=/tmp/nginx-1.10.0-1.el7.ngx.x86_64.rpm
tags: cppkg
- name: install nginx package
yum: name=/tmp/nginx-1.10.0-1.el7.ngx.x86_64.rpmstate=present
- name: install conf file nginx.conf # 调用templates模块
template: src=nginx.conf.j2 dest=/etc/nginx/nginx.conf
tags: ngxconf
notify: reload nginx service # 调用handlers模块
- name: install conf file default.conf
template: src=default.conf.j2 dest=/etc/nginx/conf.d/default.conf
tags: ngxconf # 定义tags标识
notify: reload nginx service
- name: start nginx service
service: name=nginx state=started enabled=true
2.定义在nignx/tasks中要调用模块的目录，如下：1）handlers2)准备templates的模板文件，并修改其进程数为系统变量，监听端口为自定义变量如下：
1
2
3
4
5
6
7
# cp /etc/nginx/nginx.conf nginx/templates/nginx.conf.j2
# vim nginx/templates/nginx.conf.j2
worker_processes{{ ansible_processor_vcpus }};
# cp /etc/nginx/conf.d/default.confnginx/templates/default.conf.j2
# vim nginx/templates/default.conf.j2
listen {{ ngxport }};# 自定义变量
3）准备files文件
1
2
3
# cp /root/nginx/nginx-1.10.0-1.el7.ngx.x86_64.rpm nginx/files/
# ls nginx/files/
nginx-1.10.0-1.el7.ngx.x86_64.rpm
4）因为我们在templates中用到了自定义变量，所以，在/etc/ansible/roles/nginx/vars中定义变量，如下：
1
2
# vim nginx/vars/main.yml
1 ngxport: "8088"
定义的文件概览
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# pwd
/etc/ansible/roles
# tree
.
├── httpd
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
├── memcached
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
├── mysql
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
└── nginx
├── default
├── files
│ └── nginx-1.10.0-1.el7.ngx.x86_64.rpm
├── handlers
│ └── main.yml
├── meta
├── tasks
│ └── main.yml
├── templates
│ ├── default.conf.j2
│ └── nginx.conf.j2
└── vars
└── main.yml
3.如上，我们要调用的各模块都已经准备好了，现在我们要去调用nginx角色1）首先定义play-book，指明远程主机，和要调用的角色
1
2
3
4
5
6
7
8
9
# pwd
/etc/ansible
# ls
ansible.cfgansible.cfg.bakhostshosts.bakroles
# vim roles.yaml
- hosts: ngxsrvs
remote_user: root
roles: # 这里要写调用的角色roles
- nginx
2）编辑/etc/ansible/ansible.cfg,修改其调用roles的路径
4.检测语法，测试运行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# ansible-playbook --syntax-check /etc/ansible/nginx.yaml
playbook: /etc/ansible/nginx.yaml
# 首先把程序包复制过去（因为如果远程主机没有程序报的话，测试执行后面的任务会报错）
# ansible-playbook -t cppkg/etc/ansible/nginx.yaml
PLAY *****************************************************************
TASK *******************************************************************
ok:
ok:
TASK *******************************
changed:
changed:
PLAY RECAP *********************************************************************
10.1.252.156 : ok=2 changed=1 unreachable=0 failed=0
10.1.252.161 : ok=2 changed=1 unreachable=0 failed=0
# 测试执行，
# ansible-playbook -C/etc/ansible/nginx.yaml
PLAY *****************************************************************
TASK *******************************************************************
ok:
ok:
TASK *******************************
ok:
ok:
TASK *******************************************
ok:
ok:
TASK ************************************
changed:
ok:
TASK **********************************
changed:
changed:
TASK *********************************************
changed:
changed:
RUNNING HANDLER *********************************
changed:
changed:
PLAY RECAP *********************************************************************
10.1.252.156 : ok=7 changed=4 unreachable=0 failed=0
10.1.252.161 : ok=7 changed=3 unreachable=0 failed=0
5.测试运行没有问题，然后真正的运行，在远程主机上查看，可以发现已经监听在8088端口；
1
2
3
4
5
6
7
8
9
10
11
# ss -tnl
State Recv-Q Send-Q Local Address:Port Peer Address:Port
LISTEN 0 128 *:22 *:*
LISTEN 0 128 127.0.0.1:631 *:*
LISTEN 0 128 *:8088 *:*
LISTEN 0 100 127.0.0.1:25 *:*
LISTEN 0 128 127.0.0.1:6010 *:*
LISTEN 0 128 :::22 :::*
LISTEN 0 128 ::1:631 :::*
LISTEN 0 100 ::1:25 :::*
LISTEN 0 128 ::1:6010
6.假如我们现在不想监听在8088端口，而是想监听在80端口，这时除了可以修改vars中的变量ngxport外，还可以在playbook中调用角色时，直接向角色传递变量（以字典的方式传递），如下：
因为，这里我只是修改了一下配置文件，所以只需要执行配置文件的标签ngxconf跑下配置文件即可，执行之后可以发现，远程主机监听的端口为80端口，说明直接在调用角色是传递变量要比在vars中定义的变量的优先级要高，如下：------------------------------------------------------------------------------
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# ansible-playbook --check --list-tags nginx.yaml# 列出标签
playbook: nginx.yaml
play #1 (ngxsrvs): ngxsrvs TAGS: []
TASK TAGS:
# ansible-playbook -C -t ngxconf nginx.yaml
PLAY *****************************************************************
TASK *******************************************************************
ok:
ok:
TASK ************************************
ok:
ok:
TASK **********************************
changed: # 只运行配置文件default.conf
changed:
RUNNING HANDLER *********************************
changed: # 因为配置文件发生了改变，notify通知触发脚本
changed:
PLAY RECAP *********************************************************************
10.1.252.156 : ok=4 changed=2 unreachable=0 failed=0
10.1.252.161 : ok=4 changed=2 unreachable=0 failed=0
=========================================================================== 如上，就是整个定义nginx角色并调用的整个过程，如果我们以后要在多台主机上安装运行nginx，只需要把/etc/ansible/roles/nginx目录拷贝过去然后定义主机，运行ansible-playbook就可以了,大大减轻了我们的工作量！
=========================================================================== 注意：
[*]ansible默认一次只可以调用5个主机，如果我们系统主机的性能比较好，可以根据
实际情况适当的调大一些，-f forks 也可以定义一批处理几个主机；
============================================================================2.定义memcached角色，并调用：1.首先定义memcached角色的任务目录，
1
2
3
4
5
6
7
8
9
10
# vim roles/memcached/tasks/main.yml
1 - name: install memcached
2 yum: name=memcached state=latest
3 - name: install conf file
4 template: src=memcached.j2 dest=/etc/sysconfig/memcached
5 tags: mcconf
6 notify: reload memcached
7 - name: start memcached
8 service: name=memcached state=started
2.我们这里要定义memcached的可用缓存空间为系统可用空间的四分之一，所以要调用template模块文件，定义如下：
1
2
3
4
5
6
7
# cp /etc/sysconfig/memcached roles/memcached/templates/memcached.j2
# vim roles/memcached/templates/memcached.j2
1 PORT="11211"
2 USER="memcached"
3 MAXCONN="1024"
4 CACHESIZE="{{ ansible_memtotal_mb // 4 }}"
5 OPTIONS=""
3.定义notify通知的触发器handler模块文件
1
2
3
4
# vim roles/memcached/handlers/main.yml
1 - name: reload memcached
2 service: name=memcached state=restarted
4.如上，memcached的角色就已经定义好了，现在我们在之前定义好的roles.yaml的剧本中添加上memecached角色，就可以直接调用了，如下：
1
2
3
4
5
6
7
# vim roles.yaml
1 - hosts: ngxsrvs
2 remote_user: root
3 roles:
4 - { role: nginx, ngxport: 80 }
5 - { role: memcached,tags: mechd }
5.列出tags，检查语法，运行如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# ansible-playbook --syntax-check roles.yaml# 检测语法
playbook: roles.yaml
# ansible-playbook -C --list-tags roles.yaml# 列出tags
playbook: roles.yaml
play #1 (ngxsrvs): ngxsrvs TAGS: []
TASK TAGS:
# ansible-playbook -C -t mechd roles.yaml # 运行如下
PLAY *****************************************************************
TASK *******************************************************************
ok:
ok:
TASK *******************************************
changed:
changed:
TASK *******************************************
changed:
changed:
TASK *********************************************
changed:
changed:
PLAY RECAP *********************************************************************
10.1.252.156 : ok=4 changed=0 unreachable=0 failed=0
10.1.252.161 : ok=4 changed=0 unreachable=0 failed=0
6.在远程主机查看端口11211，并查看memcached缓存大小如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# ss -tnl
State Recv-Q Send-Q Local Address:Port Peer Address:Port
LISTEN 0 128 *:11211 *:*
LISTEN 0 128 *:80 *:*
LISTEN 0 128 *:22 *:*
LISTEN 0 128 127.0.0.1:631 *:*
LISTEN 0 100 127.0.0.1:25 *:*
LISTEN 0 128 127.0.0.1:6010 *:*
LISTEN 0 128 :::11211 :::*
LISTEN 0 128 :::22 :::*
LISTEN 0 128 ::1:631 :::*
LISTEN 0 100 ::1:25 :::*
LISTEN 0 128 ::1:6010 :::*
# cat /etc/sysconfig/memcached
PORT="11211"
USER="memcached"
MAXCONN="1024"
CACHESIZE="244"
OPTIONS=""
======================================================================================3.定义mysql角色，并调用：1）定义mysql角色的任务目录，
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# vim roles/mysql/tasks/main.yml
1 - name: isntall mysql-server
2 yum: name=mysql-server state=latest
3 when: ansible_distribution == "CentOS" and ansible_distribution_major_version == "6"
4 - name: isntall mariadb-server
5 yum: name=mariadb-serverstate=latest
6 when: ansible_distribution == "CentOS" and ansible_distribution_major_version == "7"
7 - name: start mysql service
8 service: name=mysqld state=started
9 when: ansible_distribution == "CentOS" and ansible_distribution_major_version == "6"
10 - name: start mariadb service
11 service: name=mariadb state=started
12 when: ansible_distribution == "CentOS" and ansible_distribution_major_version == "7"
2）调用mysql如下：
1
2
3
4
5
6
# vim mysql.yaml
1 - hosts: dbsrvs
2 remote_user: root
3 roles:
4 - mysql
3）运行如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# ansible-playbookmysql.yaml
PLAY ******************************************************************
TASK *******************************************************************
ok:
ok:
TASK ********************************************
skipping:
changed:
TASK ******************************************
skipping:
ok:
TASK *********************************************
skipping: # when语句，不符合就跳过
changed:
TASK *******************************************
skipping:
changed:
PLAY RECAP *********************************************************************
10.1.252.161 : ok=3 changed=1 unreachable=0 failed=0
10.1.252.205 : ok=3 changed=2 unreachable=0 failed=0
总结：nginx角色的定义memcached角色定义：
nginx和memcached的角色调用：
mysql角色定义： roles目录中个角色的模块文件概览
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# tree roles
roles
├── httpd
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ ├── templates
│ └── vars
├── memcached
│ ├── default
│ ├── files
│ ├── handlers
│ │ └── main.yml
│ ├── meta
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ │ └── memcached.j2
│ └── vars
├── mysql
│ ├── default
│ ├── files
│ ├── handlers
│ ├── meta
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ └── vars
└── nginx
├── default
├── files
│ └── nginx-1.10.0-1.el7.ngx.x86_64.rpm
├── handlers
│ └── main.yml
├── meta
├── tasks
│ └── main.yml
├── templates
│ ├── default.conf.j2
│ └── nginx.conf.j2
└── vars
└── main.yml
32 directories, 10 files
如上就是整个ansible中角色roles的定义和调用。。。
页:
[1]