saltstack中grains与pillar详解

一、grains
简介
Grains是SaltStack的一个组件，存放在SaltStack的minion端。

当salt-minion启动时会把收集到的数据静态存放在Grains当中，只有当minion重启时才会进行数据的更新。

由于grains是静态数据，因此不推荐经常去修改它。

应用场景：

信息查询，可用作CMDB。
在target中使用，匹配minion。
在state系统中使用，配置管理模块。
信息查询
用于查询minion端的IP、FQDN等信息

默认可用的grains：

[root@server1 salt]# salt server3 grains.ls
server3:
    - SSDs
    - biosreleasedate
    - biosversion
    - cpu_flags
    - cpu_model
    - cpuarch
    - cwd
    - disks
    - dns
    - domain
    - fqdn
    - fqdn_ip4
    - fqdn_ip6
    - fqdns
    - gid
    - gpus
    - groupname
    - host
    - hwaddr_interfaces
    - id
    - init
    - ip4_gw
    - ip4_interfaces
    - ip6_gw
    - ip6_interfaces
    - ip_gw
    - ip_interfaces
    - ipv4
    - ipv6
    - kernel
    - kernelrelease
    - kernelversion
    - locale_info
    - localhost
    - lsb_distrib_codename
  ...等

这些信息是以键值对的形式保存的，可以使用以下命令查看键值对的信息：

[root@server1 salt]# salt server3 grains.items

也可以查看其中一项的信息：

[root@server1 salt]# salt server3 grains.item os		#查看系统
server3:
    ----------
    os:
        RedHat
[root@server1 salt]# salt server3 grains.item nodename		#查看主机名
server3:
    ----------
    nodename:
        server3
[root@server1 salt]# salt server3 grains.item shell			#查看shell类型
server3:
    ----------
    shell:
        /bin/sh

自定义grains项
1.在/etc/salt/minion中定义：

[root@server3 ~]# vim /etc/salt/minion

表示定义了一个key为roles，value为apache的grains。

重启salt-minion，否则数据不会更新：

[root@server3 ~]# systemctl restart salt-minion

在master查看：

[root@server1 salt]# salt server3 grains.item roles
server3:
    ----------
    roles:
        apache

也可以通过-G选项使用定义的grains信息对主机进行匹配：

[root@server1 salt]# salt -G 'roles:apache' test.ping
server3:
    True

2.在/etc/salt/grains中定义:

在server2：

[root@server2 salt]# vim /etc/salt/grains
[root@server2 salt]# cat /etc/salt/grains
roles: nginx

这种定义方式不需要重启minion端，但是需要同步：

[root@server1 salt]# salt server2 saltutil.sync_grains
server2:

同步后查看：

[root@server1 salt]# salt server2 grains.item roles
server2:
    ----------
    roles:
        nginx

定义成功。

3.在salt-master端创建_grains目录：

以上两种定义方式都需要在minion端操作，这种方式只需要在master端操作即可。

[root@server1 salt]# mkdir /srv/salt/_grains
[root@server1 salt]# ls
apache  _grains  _modules  nfs  nginx  top.sls
[root@server1 salt]# cd _grains/
[root@server1 _grains]# vim my_grain.py
[root@server1 _grains]# cat my_grain.py 
def my_grain():
    grains = {}
    grains['salt'] = 'stack'
    grains['hello'] = 'world'
    return grains

在_grains目录中编辑py文件定义grains，定义后需要进行同步：

[root@server1 _grains]# salt '*' saltutil.sync_grains
server2:
    - grains.my_grain
server3:
    - grains.my_grain

同步后就可以进行查看：

[root@server1 _grains]# salt '*' grains.item salt
server3:
    ----------
    salt:
        stack
server2:
    ----------
    salt:
        stack

[root@server1 _grains]# salt '*' grains.item hello
server2:
    ----------
    hello:
        world
server3:
    ----------
    hello:
        world

定义成功，但是这种方式还是将定义信息同步到minion端：

[root@server2 salt]# cd /var/cache/salt/
[root@server2 salt]# tree .

那么有没有一种方式将信息只保存在master端呢，答案就是pillar。

使用grains
在target中匹配minion：

[root@server1 salt]# salt -G ‘roles:apache’ test.ping
server3:
True
1
2
3
在top文件中匹配：

[root@server1 salt]# vim top.sls
[root@server1 salt]# cat top.sls
base:
‘roles:apache’:
- match: grain
- apache
‘roles:nginx’:
- match: grain
- nginx

以上表示匹配到’roles:apache’ grain的节点执行apache目录的文件，匹配到’roles:nginx’ grain的节点执行nginx目录的文件，

推送前注意在节点上设置对应的grains。

[root@server1 salt]# salt ‘*’ state.highstate
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

二、pillar

简介
pillar和grains一样也是一个数据系统，但是应用场景不同。

pillar是将信息动态的存放在master端，主要存放私密、敏感信息（如用户名密码等），而且可以指定某一个minion才可以看到对应的信息。

pillar更加适合在配置管理中运用。

声明pillar
pillar的默认路径是/srv/pillar，这个路径需要我们自己建立，

[root@server1 srv]# mkdir /srv/pillar
[root@server1 srv]# ls
pillar  salt

编辑定义文件：

[root@server1 srv]# cd pillar/
[root@server1 pillar]# vim web.sls
[root@server1 pillar]# cat web.sls 
{% if grains['fqdn'] == 'server3' %}
webserver: httpd
{% elif grains['fqdn'] == 'server2' %}
webserver: nginx
{% endif %}

port: 80

以上文件内容表示给server3定义pillar webserver: httpd，给server2定义pillar webserver: nginx，port: 80是共有信息，表示所有节点都有。

编辑top文件：

[root@server1 pillar]# vim top.sls
[root@server1 pillar]# cat top.sls 
base:
  '*':
    - web

以上文件内容表示对所有节点匹配web.sls文件中的pillar信息。

pillar与grains不同的是，由于其是动态的，因此pillar定义后直接就可以使用：

[root@server1 pillar]# salt '*' pillar.items
server3:
    ----------
    port:
        80
    webserver:
        httpd
server2:
    ----------
    port:
        80
    webserver:
        nginx

但是此时执行以下两条查看指令却没有返回：

[root@server1 pillar]# salt '*' pillar.item port
server2:
    ----------
    port:
server3:
    ----------
    port:
[root@server1 pillar]# salt -I 'webserver:nginx' test.ping

我们可以执行以下指令使其正常：

[root@server1 pillar]# salt '*' saltutil.refresh_pillar			#刷新pillar数据
server2:
    True
server3:
    True
[root@server1 pillar]# salt '*' pillar.item port
server3:
    ----------
    port:
        80
server2:
    ----------
    port:
        80

[root@server1 pillar]# salt -I 'webserver:nginx' test.ping
server2:
    True

在文件中使用pillar

[root@server1 pillar]# cd ../salt/
[root@server1 salt]# ls
apache  _grains  _modules  nfs  nginx  top.sls
[root@server1 salt]# cd apache/
[root@server1 apache]# ls
httpd.conf  init.sls
[root@server1 apache]# vim init.sls
[root@server1 apache]# cat init.sls 
apache:
  pkg.installed:
    - pkgs:
      - {{ pillar['webserver'] }}
  service.running:
    - name: httpd
    - reload: true
    - enable: true
    - watch:
      - file: /etc/httpd/conf/httpd.conf

/etc/httpd/conf/httpd.conf:
  file.managed:
    - source: salt://apache/httpd.conf

调用时使用{{ pillar[‘webserver’] }}的方式，表示读取推送节点的webserver pillar信息。

[root@server1 apache]# salt server3 state.sls apache