【02】Saltstack:Grains and Pillar

写在前面的话

上一节谈及了 Saltstack 的安装和初始化配置,本节将谈谈 Saltstack 中两个重要的东西,Grains 和 Pillar。

数据系统 Grains 入门

Grains 是静态数据,其数据来源于 Minion 启动的时候收集的有关客户端本地的相关信息。

包括操作系统,内核,CPU,内存,硬盘,设备型号等等。这就意味着我们可以使用 Saltstack 做资产管理。

这些静态数据除非是  Minion 重启或者 Master 端主动同步更新,否则不会改变。

1. 查看 grains 默认支持的 Key:

salt 'saltstack-node-01' grains.ls

结果如下:

我们可以看到超级多的 Key。我这里只截图了一小部分。grains.ls 这其实就是 python 里面引用 grains 模块中的 ls 方法。

2. 查看所有 Key 的值:

salt 'saltstack-node-01' grains.items

结果如图:

返回的结果其实就是 YAML 格式,后面会单独的提到 YAML 语法特点。这里我们只需要知道其实就是 K/V 结构就行。

3. 查看单独某个 Key 的值:

salt 'saltstack-node-01' grains.item os

结果如图: 

这里区别查看所有,item 采用单数的形式,如果该 Key 不存在或者没值,那么就不会有下面绿色部分的显示。

4. 我们就可以根据这里的 KV 来就行选择特定的机器,类似 K8S 中的标签选择器(Label Selector):

salt -G 'os:CentOS' cmd.run 'uptime'

结果如图:

注意,如果我们用 KV 选择需要使用 -G 参数。且这里的冒号后面没空格。

5. 当然,默认的 grains 可能无法满足我们的需求,我们可以自定义,一共有两种方法:

方法 1:在 /etc/salt/minion 配置文件的 129 行 有关于 grains 的配置(不同版本可能不一样)

可以添加一下配置进行测试:

grains:
  roles: app-server

注意 roles 前面空格 2 个,roles 后面 : 后面空格 1 个,这是 YAML 语法要求。 

然后我们重启 minion 测试一下:

systemctl restart salt-minion

在 Master 查看:

salt '*' grains.item roles

结果如图:

可以发现刚刚添加的 node3 节点已经能够看到我们新添加的 KV 配置了。

方法 2:通过方法 1 我们发现,如果都写到 minion 配置文件,不便于我们管理,所有我们可以抽离出来:

我们可以新建 /etc/salt/grains 文件,该文件能够自动被 salt 识别,直接在内部写 KV:

server_env: product
server_name: mall-server

注意冒号后面有个空格。我们也可以不重启 minion,直接在 Master 端同步,然后再度查看:

# 不重启直接同步
salt '*' saltutil.sync_grains

# 查看多个
salt '*' grains.item server_env server_name 

结果如下:

6. 或者某个 Key 的值我们还可以使用如下方法:

salt '*' grains.get os

对比 grains.item 查看结果:

我们发现使用 item 相对于使用 get 多显示了 Key

7. 自己用 Python 开发一个 grains: 方法就是写个脚本,返回一个字典即可。

首先我们需要修改 master 的配置文件:/etc/salt/master 在当前版本的 658 行有关于 file_roots 的配置,我们把配置放开。

file_roots:
  base:
    - /srv/salt

该目录同时也用于我们之后写 YAML 文件使用。当然这个目录不存在,还需要我们在 Master 节点手动建立。

# 重启 Master
systemctl restart salt-master

# 创建目录
mkdir /srv/salt

我们存放 Python 脚本的目录为:_grains

cd /srv/salt/ && mkdir _grains

我们在下面新建一个获取时间的 Python 脚本:get_time.py

#!/usr/bin/env python
#-*- coding:utf-8 -*-

import time

def get_time():
    grains = {}
    grains['year'] = time.localtime().tm_year
    grains['month'] = time.localtime().tm_mon
    grains['day'] = time.localtime().tm_mday
    return grains

然后同步到所有 Minion 节点:

salt '*' saltutil.sync_grains

结果如图:

我们可以查看同步之后的脚本在 Minion 节点放到了什么位置:

tree /var/cache/salt/

结果如图:

我们需要知道的是 /var/cache/salt 目录相当重要,从 Master 端同步的都会放到该目录下,其中红色部分就是能够执行的代码。

可以直接查看刚刚我们定义的那些 Key:

salt '*' grains.item year

结果如图:

如果这过程中出现问题,我们都可以查看日志:/var/log/salt/minion

当然,在我们定义 grains 的时候,可能会和系统的名称出现一样的情况,这就牵扯到一个优先级:

系统自带 > grains 文件中 > minion 中写的 > 自己写的

数据系统 Pillar 入门

Pillar 相比于 Grains,首先 Pillar 是动态的数据。其次 Pillar 定义在 Master 上面,只有特定的节点能看到,所以安全。

我们可以查看当前系统中的 Pillar 数据:

salt '*' pillar.items

可以看到目前是没数据的,但是其实系统是有一部分数据的,只是被隐藏了而已,如果你确实想看,可以通过修改 Master 配置实现查看,配置在 /etc/salt/master 的 878 行(我当前的版本),修改配置为如下配置,再度重启 Master 即可:

pillar_opts: True

其最终查看的结果其实际是一个叫做 master 的字典,但是并不推荐开启,因为不便于管理 pillar 配置。

我们从前面知道了 Grains 是可以直接在 minion 配置文件中定义的,那么 Pillar 需要这么定义呢?此时就可以看出 Grains 和 Pillar 的明显不同,Grains 配置在 Minion 端,Pillar 配置在 Master 端,且 Pillar 使用我们后面会经常用到的 sls 文件进行管理。至于 sls 的具体使用方法,后面会单独详讲。

1. 我们需要通过修改 master 配置文件,放开 Pillar 配置,在 /etc/salt/master 我当前版本的 828 行:

pillar_roots:
  base:
    - /srv/pillar

重启 Master 新建目录:

# 重启
systemctl restart salt-master

# 新建目录
/srv/pillar

# 查看目录结构
tree /srv/

结果如图:

2. 为了更好的进行管理,可以对 sls 文件进行归类,我们这里在 pillar 下面新建一个 test 目录,用于存放测试 sls 文件:

cd /srv/pillar/ && mkdir test

# 创建配置
vim server_role.sls

内容如下:

{% if grains['fqdn'] == 'demo-node1' %}
salt_role: master
{% else %}
salt_role: minion
{% endif %}

在该配置中我们加入了 Grains 判断。至于这个文件的语法,如果你学过 Python 并且使用过 Django 你就会发现特别熟悉,没错,Jinja2 语法。后面也会详讲,这里先简单应用。该配置大致意思就是根据主机名给不同的 Minion 设置不同的角色属性。

3. 新建 top.sls,在 Saltstack 中 sls 配置有一个统一的入口,那就是 top.sls 文件,我们这里也是简单的应用,后面讲到配置的时候单独详讲,先有这么个概念和印象就行。

vim top.sls

内容如下:

base:
  '*':
    - test.server_role

简单做个说明:* 指代所有主机,你也可以写特定的主机或者通配符,因为我们新建了 test 目录,所有我们得像 Python 调用模块一样,使用 test.server_role 来调用配置文件。此时可以查看下目录结构:

4. 同步配置,可以像 grains 一样不用重启直接同步:

salt '*' saltutil.refresh_pillar

结果如下: 

再度查看:

salt '*' pillar.item salt_role

结构如图: 

5. 使用选择器执行想要的:

salt -I 'salt_role:master' cmd.run 'w'

查看结果:

注意:这里 Pillar 的规则需要使用 -I (大写 i)参数,就行 Grains 需要使用 -G 参数一样。同时可能会遇到这样的情况,如下:

对于 Minion did not return. [No response] 这种问题,一般重启 minion 端就能解决。

小结

通过对比 Grains 和 Pillar,我们会发现其最大的特点有以下几个:

1. Grains 主要配置在 Monion,而 Pillar 主要配置在 Master。

2. Grains 可以自己用 Python 写方法,返回一个字典就行。Pillar 则是用 Salt 最为主要的 sls 配置。

3. Grains 一般是静态数据,虽然自定义的可以使用方法动态获取,而 Pillar 则是可以利用 Jinja2 模板进行逻辑判断。

4. Grains 和 Pillar 都能很好的支持数据查询,配置管理,Pillar 还能够进行敏感数据管理。

5. 两者都能很好的协助我们通过类似标签选择器(Label Selector)的方式对服务器进行批量选择。

注意:这里所说的所谓保护敏感数据其实是因为我们在 Master 端做的定义,这样即使黑客攻陷了某台 Minion 他也无法拿到敏感数据而已。

原文地址:https://www.cnblogs.com/Dy1an/p/11105991.html