Saltstack (四) --- grains与pillar详解

女爷i 2023-03-14 10:48 12阅读 0赞

### grains与pillar详解 ###

*  一、grains
 *   *  简介
     *  信息查询
     *  自定义grains项
     *  使用grains
 *  二、pillar
 *   *  简介
     *  声明pillar
     *  在文件中使用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

![在这里插入图片描述][20200517165239534.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

定义成功。

**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 .

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1ODg3NTQ2_size_16_color_FFFFFF_t_70]那么有没有一种方式将信息只保存在master端呢，答案就是pillar。

## 使用grains ##

在target中匹配minion：

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

在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

# 二、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_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1ODg3NTQ2_size_16_color_FFFFFF_t_70 1]可以看到匹配的信息是httpd。

[20200517165239534.png]: /images/20230312/36153d5e6b37457ba620c904a8574999.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1ODg3NTQ2_size_16_color_FFFFFF_t_70]: /images/20230312/6eb1437e2ba54bc2a215e43d5a333aac.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM1ODg3NTQ2_size_16_color_FFFFFF_t_70 1]: /images/20230312/2d1397a34221406c8d8bf7c97cea5dbf.png