SLS文件(即SaLt State文件)
它是Salt State系统的核心。SLS描述了系统的目标状态,由格式简单的数据构成,也经常被称作配置管理。
top.sls 是配置管理的入口文件,一切调用都从此文件开始,在master 主机上,默认存放在/srv/salt/目录。 top.sls 默认从 base 标签开始解析执行,下一级是操作的目标,可以通过正则,grain模块,或分组名,来进行匹配,再下一级是要执行的state文件,不包换扩展名。
例:创建 /srv/salt/top.sls
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
[root@redis01-jp ~]
# cat /srv/salt/base/top.sls
base:
'*'
:
- apache
'roles:cacheserver'
:
- match: grain
- nginx
pushServer:
- match: nodegroup
- dns
prod:
'redis02-jp'
:
- haproxy
[root@redis01-jp ~]
#
|
说明:此文件可以使用正则表达式进行匹配(上例中的*);
可以使用grain模块获得到的值进行匹配,但必须有 - match: grain 语句
可以使用主机分组名进行匹配,但必须有 - match: nodegroup 语句
SLS文件命名空间
注意在上例中,SLS文件 nginx.sls 被简称为nginx.
SLS文件命名空间有如下几条基本的规则:
1、SLS文件的扩展名 .sls 被省略 (例如. nginx.sls 变成 nginx)
2、子目录可以更好的组织,每个子目录都由一个点来表示,调用时需要指定:子目录名.文件名(例如 apache/install.sls 可以简称为apache.install)
3、如果子目录创建一个init.sls的文件,引用的时候仅指定该目录即可. (例如 apache/init.sls 可以简称为 apache)
关于salt-minion端 grain 的设置如下:
1
2
3
4
5
6
7
8
9
|
[root@redis02-jp ~]
# vim /etc/salt/minion
[root@redis02-jp ~]
# sed -n '120,122p' /etc/salt/minion
grains:
roles:
- cacheserver
[root@redis02-jp ~]
# service salt-minion restart
Stopping salt-minion daemon: [ OK ]
Starting salt-minion daemon: [ OK ]
[root@redis02-jp ~]
#
|
关于salt-master端的主机分组设置如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
[root@redis01-jp ~]
# sed -n '516,522p;988,991p' /etc/salt/master
file_roots:
base:
-
/srv/salt/base
test
:
-
/srv/salt/test
prod:
-
/srv/salt/prod
nodegroups:
cacheServers:
'L@redis02-jp,redis03-jp'
pushServers:
'G@role:push'
zayhuServers:
'G@role:uc and G@role:zrouter'
[root@redis01-jp ~]
# service salt-master restart
Stopping salt-master daemon: [ OK ]
Starting salt-master daemon: [ OK ]
[root@redis01-jp ~]
#
|
在salt-master端定义三个组,定义方法说明如下:
L@minion_id1,minion_id2......
G@grain:value
G@grain:value1 and G@graint:value2 ......
各子目录及文件内容如下所示:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
[root@redis01-jp ~]
# ls /srv/salt/base/
apache dns.sls files nginx.sls
top
.sls
[root@redis01-jp ~]
# ls /srv/salt/base/apache/
init.sls
[root@redis01-jp ~]
# cat /srv/salt/base/apache/init.sls
apache:
#定义标签名,一般标签名可以替换name属性
pkg:
- name: httpd
#手工指定name属性
- installed
service:
- name: httpd
-
enable
: True
- running
- require:
#依赖其它资源
- pkg: httpd
#依赖 pkg 模块的 httpd资源
[root@redis01-jp ~]
# salt '*' state.highstate
|
主控端对目标主机(targeted minions)发出指令运行state.highstatem模块,目标主机首先会将top.sls下载、解析、编译,然后按照top.sls内匹配规则定义的模块将其下载、解析、编译、执行,然后结果反馈给 master.
1
2
3
4
5
6
7
8
9
|
[root@redis01-jp ~]
# cat /srv/salt/base/nginx.sls
nginx:
#本例中标签名与name属性重合,在以下模块中就可以省略name属性
pkg:
- latest
#保证最新版本,省略name属性
service.running:
-
enable
: True
#service模块也省略了name 属性
- require:
- pkg: nginx
#依赖资源时的语法是 模块名: name值
[root@redis01-jp ~]
#
|
state的逻辑关系列表
match: 配模某个模块,比如 match: grain match: nodegroup
require: 依赖某个state,在运行此state前,先运行依赖的state,依赖可以有多个
watch: 在某个state变化时运行此模块
order: 优先级比require和watch低,有order指定的state比没有order指定的优先级高