天天看点

Saltstack SLS文件解读

SLS(代表SaLt State文件)是Salt State系统的核心。SLS描述了系统的目标状态,由格式简单的数据构成。这经常被称作配置管理

目录[-]

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h1_1" target="_blank">SLS文件</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_2" target="_blank">简述</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_3" target="_blank">top.sls</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_4" target="_blank">SLS文件命名空间</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_5" target="_blank">state多文件示例</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_6" target="_blank">state的层级关系</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h3_7" target="_blank">include 示例:</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h3_8" target="_blank">extend 示例:</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_9" target="_blank">state的逻辑关系列表</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_10" target="_blank">state的逻辑关系实例</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_11" target="_blank">进阶主题:模板</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h3_12" target="_blank">使用模板来精简SLS,使SLS可以使用python的 循环,分支,判断 等逻辑</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h3_13" target="_blank">通过加载jinja模板引擎,可以模板配置文件按照预订条件来生成最终的配置文件</a>

<a href="http://my.oschina.net/u/877567/blog/183959#OSC_h2_14" target="_blank">参考文档</a>

SLS文件

简述

top.sls

top.sls 是配置管理的入口文件,一切都是从这里开始,在master 主机上,默认存放在/srv/salt/目录. top.sls 默认从 base 标签开始解析执行,下一级是操作的目标,可以通过正则,grain模块,或分组名,来进行匹配,再下一级是要执行的state文件,不包换扩展名。

创建 /srv/salt/top.sls

·        通过正则进行匹配的示例,

base:

  '*':

    - webserver

·        通过分组名进行匹配的示例,必须要有 - match: nodegroup

  group1:

    - match: nodegroup   

·        通过grain模块匹配的示例,必须要有- match: grain

  'os:Fedora':

    - match: grain

准备好top.sls文件后,编写一个state文件

·        /srv/salt/webserver.sls

apache:                 # 标签定义

  pkg:                  # state declaration

    - installed         # function declaration

·        第一行被称为(ID declaration)标签定义,在这里被定义为安装包的名。注意:在不同发行版软件包命名不同,比如 fedora 中叫httpd的包 Debian/Ubuntu中叫apache2

·        第二行被称为(state declaration)状态定义,在这里定义使用(pkg state module)

·        第三行被称为(function declaration)函数定义,在这里定义使用(pkg state module)调用 installed 函数

最后可以在终端中执行命令来查看结果:

salt'*' state.highstate

或附件 test=True参数测试执行

salt'*' state.highstate -v test=True

主控端对目标主机(targeted minions)发出指令运行state.highstatem模块,目标主机首先会对top.sls下载,解析,然后按照top.sls内匹配规则内的定义的模块将被下载,解析,执行,然后结果反馈给 master.

SLS文件命名空间

注意在以上的例子中,SLS文件 webserver.sls 被简称为webserver. SLS文件命名空间有如下几条基本的规则:

1.    SLS文件的扩展名 .sls 被省略。 (例如. webserver.sls 变成 webserver)

2.    子目录可以更好的组织,每个子目录都由一个点来表示.(例如 webserver/dev.sls 可以简称为 webserver.dev)

3.    如果子目录创建一个init.sls的文件,引用的时候仅指定该目录即可. (例如 webserver/init.sls 可以简称为 webserver)

4.    如果一个目录下同时存在webserver.sls 和 webserver/init.sls,那么 webserver/init.sls 将被忽略,SLS文件引用的webserver将只引用webserver.sls

state多文件示例

下面是一个state多文件示例,

apache/init.sls

apache/httpd.conf

ssh/init.sls

ssh/server.sls

ssh/banner

ssh/ssh_config

ssh/sshd_config

创建一个引用这些目录的 server.sls

server:

  - apache

  - ssh

state的层级关系

include 示例:

·        include 包含某个state文件

/srv/salt/apache.sls

apache:

  pkg:

    - installed

  service:

    - running

    - require:

      - pkg: apache

使用 include 可以包换有state文件而不必重新写

·        /srv/salt/apache-custom.sls

include:

  apache

extend 示例:

·        extend 与include配合使用,作用是修改,或扩展引用的state文件的某个字段

extend默认是替换引用文件的某个字段的属性,如例

·        /srv/salt/apache-change.sls

extend:

  apache 

    pkg:

      - name: vim

      - installed

当extend与watch,或require结合使用的时候,则是扩展某个字段的属性,如例:

    service:

      - watch:

        - file: /etc/redis.conf

state的逻辑关系列表

·        match: 配模某个模块,比如 match: grain match: nodegroup

·        require:依赖某个state,在运行此state前,先运行依赖的state,依赖可以有多个

·        watch:在某个state变化时运行此模块

·        order:优先级比require和watch低,有order指定的state比没有order指定的优先级高

state的逻辑关系实例

httpd:                                  # maps to"name"

  pkg:   

    - installed 

  file:                                # maps to Statemodule filename

    - managed:                          # maps to the managedfunction in the file State module

    - name: /etc/httpd/conf/httpd.conf  # one of many options passed to the managefunction

    - source: salt://httpd/httpd.conf

    - require: 

      - pkg: httpd

·        watch:在某个state变化时运行此模块,watch除具备require功能外,还增了关注状态的功能。

redis:

    - latest

  file.managed:

    - source: salt://redis/redis.conf

    - name: /etc/redis.conf

      - pkg: redis

  service.running:

    - enable: True

    - watch:

      - file: /etc/redis.conf

vim:

  pkg.installed:

    - order: 1

想让某个state最后一个运行,可以用last

进阶主题:模板

使用模板来精简SLS,使SLS可以使用python的循环,分支,判断等逻辑

{%for item in ['tmp','test'] %}

/opt/`item `:

  file.directory:

    - user: root

    - group: root

    - mode: 755

    - makedirs: True

{%endfor %}

httpd:

  pkg.managed:

{%if grains['os'] == 'Ubuntu' %}

    - name: apache2

{%elif grains['os'] == 'CentOS' %}

    - name: httpd

{%endif %}

通过加载jinja模板引擎,可以模板配置文件按照预订条件来生成最终的配置文件

/opt/test.conf

host:{{ grains['host'] }}

host:{{ grains['fqdn'] }}

/opt/test.conf:

    - source: salt://test.conf

    -user: root

    - mode: 644

    - template: jinja

转自:http://my.oschina.net/u/877567/blog/183959

本文转自奔跑在路上博客51CTO博客,原文链接http://blog.51cto.com/qiangsh/1789911如需转载请自行联系原作者

qianghong000