playbook 目录包括变量定义目录 group_vars、主机组定义文件hosts、全局配置文件site.yml、角色功能目录。
可以使用命令 ansible-galaxy init 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
| [root@localhost ~]# tree ansible_roles/
ansible_roles/
├── common # 公共角色目录
│ ├── handlers
│ │ └── main.yml # 定义触发任务
│ ├── tasks
│ │ └── main.yml # 定义任务
│ ├── templates
│ │ └── ntp.conf.j2 # 定义模板
│ └── vars
│ └── main.yml # 定义角色内的变量
├── ftp # 安装ftp任务角色
│ ├── handlers
│ │ └── main.yml
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ │ └── vsftpd2.conf
│ └── vars
├── group_vars # 定义组变量，以组名命名文件
│ ├── all
│ └── ftpservers # 定义 ftpservers 组主机变量
├── hosts # 主机清单，非必须，可以使用默认。使用时加 -i 选项
└── site.yml # 程序入口文件
|
角色定制以下规范，其中 x 为角色名。
- 如
roles/x/tasks/main.yml 文件存在，其中列出的任务将被添加到执行队列； - 如
roles/x/handlers/main.yml 文件存在，其中所列的处理程序将被添加到执行队列； - 如
roles/x/vars/main.yml 文件存在，其中列出的变量将被添加到执行队列； - 如
roles/x/meta/main.yml 文件存在，所列任何作用的依赖关系将被添加到角色的列表（1.3及更高版本）； - 任何副本任务可以引用
roles/x/files/无需写路径，默认相对或绝对引用； - 任何模板任务可以引用文件中的
roles/x/templates/ 无需写路径，默认相对或绝对引用。
1
2
3
4
5
6
| [root@localhost ansible_roles]# cat hosts
manages ansible_connection=local ansible_ssh_host=127.0.0.1
[ftpservers]
192.168.17.130
192.168.17.131
|
group_vars/ftpservers 此配置文件内变量只对 ftpservers 组内的主机有效
1
2
3
| [root@localhost ansible_roles]# cat group_vars/ftpservers
userlist: /etc/vsftpd/user_list
welcome: /etc/vsftpd/welcome.txt
|
group_vars/all 对所有主机有效
1
2
| [root@localhost ansible_roles]# cat group_vars/all
ntpserver: ntp.sjtu.edu.cn
|
1
2
3
4
5
6
7
8
9
10
11
12
13
| [root@localhost ansible_roles]# cat site.yml
---
# 任务名
- name: apply common configuration to all nodes
hosts: all # 任务操作主机或主机组
roles: # 指定任务角色
- common # 运行 common角色
- name: configure and deploy the ftpservers
hosts: ftpservers
roles:
- ftp
|
全局配置文件 site.yml 引用了两个角色，一个为公共类的 common，另一个为 ftp 类，分别对应 nginx/common、nginx/web 目录。以此类推，可以引用更多的角色，如 db、nosql、hadoop 等，前提是我们先要进行定义，通常情况下一个角色对应着一个特定功能服务。通过 hosts 参数来绑定角色对应的主机或组.
角色common定义了handlers、tasks、templates、vars 4个功能类，分别存放处理程序、任务列表、模板、变量的配置文件main.yml，需要注意的是，vars/main.yml中定义的变量优先级高于/nginx/group_vars/all，可以从ansible-playbook的执行结果中得到验证。各功能块配置文件定义如下：
common/tasks/main.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| [root@localhost ansible_roles]# cat common/tasks/main.yml
---
- name: install ntp
yum: name=ntp state=present
- name: configure ntp file
template: src=ntp.conf.j2 dest=/etc/ntp.conf
notify: restart ntp
- name: start the ntp service
service: name=ntpd state=started enabled=true
- name: test to see if selinux is running
command: getenforce
register: sestatus
changed_when: false
|
common/handlers/main.yml
1
2
3
4
| [root@localhost ansible_roles]# cat common/handlers/main.yml
---
- name: restart ntp
service: name=ntpd state=restarted
|
common/templates/main.yml
1
2
3
4
5
6
7
8
9
| [root@localhost ansible_roles]# cat common/templates/ntp.conf.j2
driftfile /var/lib/ntp/drift
restrict 127.0.0.1
restrict -6 ::1
server {{ ntpserver }}
includefile /etc/ntp/crypto/pw
keys /etc/ntp/keys
|
{{ ntpserver }} 变量将从 common/vars/main.yml 中获取
common/vars/main.yml
1
2
| [root@localhost ansible_roles]# cat common/vars/main.yml
ntpserver: 210.72.145.44
|
Tips: 此处定义的变量优先级要高于 group_vars 中定义的变量
ftp/tasks/main.yml
1
2
3
4
5
6
7
8
9
10
| [root@localhost ansible_roles]# cat ftp/tasks/main.yml
- name: install vsftpd
yum: pkg=vsftpd state=latest
- name: write the vsftpd config file
template: src=vsftpd2.conf dest=/etc/vsftpd/vsftpd.conf
notify:
- restart vsftpd
- name: start vsftpd
service: name=vsftpd state=started
|
ftp/handlers/main.yml
1
2
3
4
| [root@localhost ansible_roles]# cat ftp/handlers/main.yml
---
- name: restart vsftpd
service: name=vsftpd state=restarted
|
ftp/templates/vsftpd2.conf
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
| [root@localhost ansible_roles]# cat ftp/templates/vsftpd2.conf
anonymous_enable=NO
local_enable=YES
write_enable=YES
local_umask=022
local_root=/var/ftp
userlist_enable=YES
userlist_deny=YES
userlist_file={{ userlist }}
use_localtime=YES
dirmessage_enable=YES
xferlog_enable=YES
connect_from_port_20=YES
xferlog_std_format=YES
listen=YES
pam_service_name=vsftpd
tcp_wrappers=YES
banner_file={{ welcome }}
chroot_local_user=YES
pasv_min_port=65530
pasv_max_port=65535
|