saltstack中grains与pillar详解

亦凉 2023-02-10 03:54 24阅读 0赞

一、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
      ...等

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70]  
这些信息是以键值对的形式保存的，可以使用以下命令查看键值对的信息：

[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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70 1]  
自定义grains项  
1.在/etc/salt/minion中定义：

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

![在这里插入图片描述][20200519232026749.png]  
表示定义了一个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

定义成功。  
![在这里插入图片描述][2020051923230479.png]

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 .

![在这里插入图片描述][20200519232434506.png]  
那么有没有一种方式将信息只保存在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

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70 2]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200519231739607.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200519231904379.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3,size_16,color_FFFFFF,t_70
[20200519232026749.png]: https://img-blog.csdnimg.cn/20200519232026749.png
[2020051923230479.png]: https://img-blog.csdnimg.cn/2020051923230479.png
[20200519232434506.png]: https://img-blog.csdnimg.cn/20200519232434506.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200519232804176.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM2NDE3Njc3,size_16,color_FFFFFF,t_70