saltstack sls文件语法解释及示例
1. sls文件本质上是python嵌套字典(键值对)，由salt-master以广播的形式传递给salt-minion，通过sls文件告知使用哪个模块的哪个函数，参数有哪些，在salt-minion一侧进行函数调用
2. 冒号':' 用来分隔键和值， 冒号：与后面的单词如果在一行，一定要有一个空格， 一个单词后面是否有冒号：取决于这个单词是否是key, 后面是否有值或者是嵌套的内容
短横杠 - 表示这项是个列表项， 短横杠与后面的单词有一个空格
缩进： 本层与下一层要有缩进， 缩进不能用tab, 一般是两个空格. 相同一缩进表示相同的层级
一个sls文件示例：httpd.sls
httpd: -------> httpd: sls文件的id,在此sls文件中不能重复，同时也是yum安装的包名和服务名，作为参数name传递给pkg.installed函数和service.running函数
pkg: -------> pkg是包管理模块，对应/usr/lib/python2.6/site-packages/salt/states下的模块pkg.py
- installed -------> installed是pkg模块下的函数，id(httpd)作为installed的参数进行调用
service: ------->service是服务模块，对应/usr/lib/python2.6/site-packages/salt/states下的模块service.py, 由于service是一个key,其下的running, require, watch是列表形式的值，因此service之后有冒号
- running -------> running是service.py模块下的函数，id(httpd)作为running的参数进行调用
- require: ------->require关键字在 /usr/lib/python2.6/site-packages/salt/state.py里定义的,由于require是key,其下还有子层，因此require后面要有冒号: 且与后面的单词有一个空格
- pkg: httpd
- watch: ------->require关键字在 /usr/lib/python2.6/site-packages/salt/state.py里定义的,由于watch是key,其下还有子层，因此require后面要有冒号：且与后面的单词有一个空格
- file: /etc/httpd/conf/httpd.conf
/etc/httpd/conf/httpd.conf:
file: ------->file是salt的文件管理模块，对应/usr/lib/python2.6/site-packages/salt/states下的模块file.py
- managed -------> managed是file.py模块里的一个函数
- source: salt://httpd.conf -------> source是managed函数的参数之一
- require:
- pkg: httpd
sls文件的执行： salt '*' state.sls httpd (注意:是httpd,不是httpd.sls)
另一个sls文件示例：mysql.sls
mysql-server: -------> 这是要安装的包名，也是sls文件的id,不能重复
pkg:
- installed -------> installed的下一行应该是,- name: mysql-server指明要安装的包名,但是由于包名与id(mysql-server)相同，因此, 无须再单独指明installed函数的参数，-name: mysql-server省略
service.running:
- name: mysqld -------> - name 这是service.running函数的参数，如果包名与服务名相同，则- name这项可以省略，但本案例中包名是mysql-server,服务名是mysqld，因此必须有-name 指明running函数的参数是mysqld
- require: -------> require是依赖的含义：要运行服务mysqld, 必须安装mysql-server的包
- pkg: mysql-server
- watch: -------> watch: 表示对文件/etc/my.cnf的监控，当master 向minion传递my.cnf时，新的my.cnf与minion上原有文件不一致时，会重启mysqld服务
- file: /etc/my.cnf
/etc/my.cnf: -------> 这一行同样是id不能重复：表示传递到minion时所处的位置，同时也作为file.managed函数的参数，对应name形参
file.managed: -------> 同上一个示例，file.py模块的managed函数，下面的source，user, group, mode都是managed函数的参数
- source: salt://my.cnf -------> source 是managed函数的参数，指定要传递到minion端的源文件. salt://my.cnf 表示my.cnf在/srv/salt之下，/srv/salt是saltstack的根目录
- user: root -------> 表示文件的属主
- group: root -------> 表示文件的属组
- mode: 644 -------> 表示文件的权限
- require: -------> 文件从master传递到minion, 需要依赖mysql-server包的安装
- pkg: mysql-server
sls文件的执行： salt '*' state.sls mysql (注意:是mysql,不是mysql.sls)
上面示例文件的格式有点乱，在下面重新写一下：
[root@salt-master salt]# vim httpd.sls
httpd:
pkg:
- installed
service.running: #注意: 这种写法时running后面有冒号, 与上面的写法略有不同，但效果相同
- require:
- pkg: httpd
- watch:
- file: /etc/httpd/conf/httpd.conf
/etc/httpd/conf/httpd.conf:
file.managed: #注意: 这种写法时managed后面有冒号, 与上面的写法略有不同，但效果相同
- source: salt://httpd.conf
- require:
- pkg: httpd
[root@salt-master salt]# vim mysql.sls
mysql-server:
pkg:
- installed
service.running:
- name: mysqld
- require:
- pkg: mysql-server
- watch:
- file: /etc/my.cnf
/etc/my.cnf:
file.managed:
- source: salt://my.cnf
- user: root
- group: root
- mode: 644
- require:
- pkg: mysql-server
安装zabbix-agent的示例
[root@salt-master salt]# vim zabbix-agent.sls
zabbix-agent:
pkg:
- installed
service.running:
- require:
- pkg: zabbix-agent
- watch:
- file: /etc/zabbix/zabbix_agentd.conf
/etc/zabbix/zabbix_agentd.conf:
file.managed:
- source: salt://zabbix_agentd.conf
- user: root
- group: root
- mode: 644
