死磕salt系列-salt 配置文件管理

SLS是Salt State系统的核心，用来描述系统的目标状态，使用YAML语言书写。被用作配置文件管理。

SLS文件

sls配置文件分为两种类型

• top.sls 这是所有配置文件的入口
• sls 这是每个不同的配置文件

top.sls

• top.sls 文件是其他sls文件的起始位置，使用salt '*' state.highstate调用。
• top.sls 文件的位置：master文件中base环境定义的文件夹下。
• 假设base路径为：/srv/salt/base 则top文件路径：/srv/salt/base/top.sls

top.sls 文件格式如下：

base: ## 从哪里开始读取配置文件，可以是base，prod等，
  'os:centos':   ## 目标主机
    - match: grain  ## match 匹配方式，
    - init.env_init  ## 需要执行的什么命令
    - zabbix-agent-linux.config
    - salt.agent

prod:
  'blog.*.(service|mongodb|proxydb)':
    - match: pcre
    - publish.config
    - filebeat.config

解释：

• top文件遵循YAML语法，不同的层级用不同的空格定义。
• base：表示文件的其实位置。
• 'os:centos' ：表示目标主机。
• match：

• grain: 按照grains规则去匹配
• nodegroup: 按照分组名进行匹配
• pcre: 正则匹配
• 如果不写match行，则默认使用通配符匹配。

sls文件编写方法

agent-config:  ##定义一个名称
  file.managed:  ## 定义一个方法
    - name: /etc/salt/minion   ##定义方法需要的相关参数
    - source: salt://salt/files/minion-config
    - user: root
    - group: root
    - mode: 644
    - template: jinja  ##启用jinja模板匹配

简写方法：

vim /srv/salt/apache/install.sls

apache:                 # 定义名称
  pkg:                     # 定义函数
    - installed         # 定义方法

简版的语法与上面的语法一致，区别在于可以将名称写在行首。这样就不用定义方法名称了。

最后执行 salt '*' state.highstate test=True测试编写的文件是否正常。结果正常，则去掉test=True正式执行。

sls编写方法注意事项

• include可以把已经写好的文件包含进来一起执行。
• 一个agent-config代表一个命名空间，一个命名空间内只有有一种方法即file.managed方法只能出现一次。
• 如果写多个file.managed就需要使用不用的命名空间。
• - template: jinja 表示配置文件中定义了jinja模板。
• 缩进用空格(一般是2个),不要用tab
• :表示是字典
• -表示是列表

include: 
  apache.install
  
agent-config:  
  file.managed:  
    - name: /etc/salt/minion   
    - source: salt://salt/files/minion-config
    - user: root
    - group: root
    - mode: 644
    - template: jinja  
    - require:
      - pkg: apache

include: 
  apache.install

include 声明

一个list，其元素是要引用到本SLS文件的其他SLS模块。 只能用在highstate结构的顶层

include:
  - edit.vim      
  - http.server

引用其他环境变量的sls文件:

include:
  - dev: http

相对引用:

include:
include:
  - .virt
  - .virt.hyper
  - ..http
  - ...base

其中的语法类似于python中的相对引用

jinja模板语法：

小技巧：
使用{{ salt['granins.get']('user'),'larry' }}, {{ salt['pillar.get']('user'),'larry' }}的方法提供默认值。

{% for i in ['/etc/','/usr']%}
touch  {{ i }}/1.txt
{% endfor %}

httpd:
  pkg.managed:
{% if grains['os'] == 'Ubuntu' %}
    - name: apache2
{% elif grains['os'] == 'CentOS' %}
    - name: httpd
{% endif %}
    - installed

set 这是jinja模板的值

{% set site_user = 'testuser' %}
{% set site_name = 'test_site' %}
{% set project_name = 'test_proj' %}
{% set sites_dir = 'test_dir' %}

django-project:
  file.recurse:
    - name: {{ sites_dir }}/{{ site_name }}/{{ project_name }}
    - user: {{ site_user }}
    - dir_mode: 2775
    - file_mode: '0644'
    - template: jinja
    - source: salt://project/templates_dir
    - include_empty: True

- require表示依赖，Apache表示命名空间，pkg表示命名空间中的某一个方法。

    - require:
      - pkg: apache

其他配置

• watch： 监控状态是否变化，常用在service.running中。
• last：想让某个state最后一个运行，可以用last。
• order：优先级比require和watch低，有order指定的state比没有order指定的优先级高。

vim:
  pkg.installed:
    - order: 1