saltstack sls文件语法解释及示例

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