SaltStack数据系统
SaltStack有两大数据系统,分别是:
- Grains
- Pillar
SaltStack数据系统组件
Grains
Grains是SaltStack的一个组件,其存放着minion启动时收集到的信息。
Grains是SaltStack组件中非常重要的组件之一,因为我们在做配置部署的过程中会经常使用它,Grains是SaltStack记录minion的一些静态信息的组件。可简单理解为Grains记录着每台minion的一些常用属性,比如CPU、内存、磁盘、网络信息等。我们可以通过grains.items查看某台minion的所有Grains信息。
Grains的功能:
- 收集资产信息
Grains应用场景:
- 信息查询
- 在命令行下进行目标匹配
- 在top file中进行目标匹配
- 在模板中进行目标匹配
环境说明:
主机名 | ip | 需要安装的应用 |
---|---|---|
msater | 192.168.58.120 | salt-master、salt-minion |
node2 | 192.168.58.121 | salt-minion |
node3 | 192.168.58.30 | salt-minion |
信息查询实例:
1.列出所有grains的key和value
[root@master ~]# salt 'node2' grains.items
node2:
----------
biosreleasedate: //bios的时间
07/22/2020 //bios版本
biosversion: //cpu相关属性
6.00
cpu_flags:
- fpu
- vme
- de
`......此处省略n行
cpu_model: //cpu的具体型号
Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
cpuarch: //cpu架构
x86_64
cwd:
/
disks:
- sr0
dns:
----------
domain:
ip4_nameservers:
- 114.114.114.114
ip6_nameservers:
nameservers:
- 114.114.114.114
options:
search:
sortlist:
domain:
efi:
False
efi-secure-boot:
False
fqdn:
node2
fqdn_ip4: //ip 地址
- 192.168.58.121
fqdn_ip6:
- fe80::cfb9:ea79:ec31:a606
fqdns:
- minion
gid:
0
gpus:
|_
----------
model:
SVGA II Adapter
vendor:
vmware
groupname:
root
host: //主机名
node2
hwaddr_interfaces:
----------
ens160:
00:0c:29:e5:44:fe
lo:
00:00:00:00:00:00
id:
node2
init:
systemd
ip4_gw:
192.168.58.2
ip4_interfaces:
----------
ens160:
- 192.168.58.121
lo:
- 127.0.0.1
只查询所有的grains的key
[root@master ~]# salt 'node3' grains.ls
node3:
- biosreleasedate
- biosversion
- cpu_flags
- cpu_model
- cpuarch
- cwd
- disks
- dns
- domain
- efi
- efi-secure-boot
- 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
- kernelparams
- kernelrelease
- kernelversion
- locale_info
- localhost
- lsb_distrib_codename
- lsb_distrib_id
- lsb_distrib_release
- lvm
- machine_id
- manufacturer
- master
- mdadm
- mem_total
- nodename
- num_cpus
- num_gpus
- os
- os_family
- osarch
- oscodename
- osfinger
- osfullname
- osmajorrelease
- osrelease
- osrelease_info
- path
- pid
- productname
- ps
- pythonexecutable
- pythonpath
- pythonversion
- saltpath
- saltversion
- saltversioninfo
- selinux
- serialnumber
- server_id
- shell
- ssds
- swap_total
- systemd
- systempath
- transactional
- uid
- username
- uuid
- virtual
- zfs_feature_flags
- zfs_support
- zmqversion
查询某个key的值,比如列出所有主机的ip地址
[root@master ~]# salt '*' grains.get fqdn_ip4
node3:
- 192.168.58.30
node2:
- 192.168.58.121
master:
- 192.168.58.120
node4:
- 192.168.58.40
[root@master ~]# salt '*' grains.get ip4_interfaces
master:
----------
ens160:
- 192.168.58.120
lo:
- 127.0.0.1
node2:
----------
ens160:
- 192.168.58.121
lo:
- 127.0.0.1
node4:
----------
ens160:
- 192.168.58.40
lo:
- 127.0.0.1
node3:
----------
ens160:
- 192.168.58.30
lo:
- 127.0.0.1
[root@master ~]# salt '*' grains.get ip4_interfaces:ens160
node2:
- 192.168.58.121
master:
- 192.168.58.120
node4:
- 192.168.58.40
node3:
- 192.168.58.30
键(key)和值(values)分别是什么 分别怎么取
[root@master ~]# salt 'master' grains.get ip4_interfaces
master:
----------
ens160:
- 192.168.58.120
lo:
- 127.0.0.1
获取取(key)键的时候用(.)英文的逗号,以上面的为例
取ens160网卡的(key)键
[root@master ~]# salt 'master' grains.get ip4_interfaces.ens160
master:
获取取(key)键的时候用(:)英文的冒号,以上面的为例
取ens160网卡的键值
[root@master ~]# salt 'master' grains.get ip4_interfaces:ens160
master:
- 192.168.58.120
目标匹配实例:
用Grains来匹配minion:
[root@master ~]# salt -G 'os:redhat' cmd.run 'uptime' //列出系统为redhat的正常运行时间
node4:
15:37:25 up 4:43, 2 users, load average: 0.17, 0.30, 0.32
node3:
15:37:25 up 4:44, 2 users, load average: 0.15, 0.25, 0.30
node2:
15:37:25 up 4:51, 2 users, load average: 0.21, 0.19, 0.22
master:
15:37:25 up 4:51, 2 users, load average: 0.91, 0.52, 0.42
在top file里面使用Grains:
//在所有RedHat系统中执行命令
[root@master base]# cat top.sls
base:
'master':
- web.nginx.install_n
'os:RedHat':
- match: grain
- web.apache.install_a
[root@master base]# salt -G 'os:RedHat' state.highstate
自定义Grains的两种方法:
- minion配置文件,在配置文件中搜索grains
- 在/etc/salt下生成一个grains文件,在此文件中定义(推荐方式)
[root@master ~]# vim /etc/salt/grains
[root@master ~]# cat /etc/salt/grains
xu-grains: meng
[root@master ~]# systemctl restart salt-minion
[root@master ~]# salt '*' grains.get xu-grains
node4:
node2:
node3:
master:
meng
不重启的情况下自定义Grains:
[root@master ~]# vim /etc/salt/grains
meng-grains: xym like 晴天 晴天 = jay so xym = jay
[root@master ~]# salt '*' saltutil.sync_grains
node2:
master:
node3:
node4:
[root@master ~]# salt '*' grains.get meng-grains
node3:
node2:
master:
xym like 晴天 晴天 = jay so xym = jay
node4:
Pillar
Pillar也是SaltStack组件中非常重要的组件之一,是数据管理中心,经常配置states在大规模的配置管理工作中使用它。Pillar在SaltStack中主要的作用就是存储和定义配置管理中需要的一些数据,比如软件版本号、用户名密码等信息,它的定义存储格式与Grains类似,都是YAML格式。
在Master配置文件中有一段Pillar settings选项专门定义Pillar相关的一些参数:
#pillar_roots:
# base:
# - /srv/pillar
默认Base环境下Pillar的工作目录在/srv/pillar目录下。若你想定义多个环境不同的Pillar工作目录,只需要修改此处配置文件即可。
Pillar的特点:
- 可以给指定的minion定义它需要的数据
- 只有指定的人才能看到定义的数据
- 在master配置文件里设置
查看pillar的信息
[root@master ~]# salt '*' pillar.items
node3:
----------
master:
----------
node4:
----------
node2:
----------
默认pillar是没有任何信息的,如果想查看信息,需要在 master 配置文件上把 pillar_opts的注释取消,并将其值设为 True。
[root@master base]# vim /etc/salt/master
# master config file that can then be used on minions.
pillar_opts: True
....
[root@master ~]# systemctl restart salt-master
[root@master ~]# salt 'master' pillar.items
master:
----------
master:
----------
__cli:
salt-master
__role:
master
allow_minion_key_revoke:
True
archive_jobs:
False
auth_events:
True
auth_mode:
1
auto_accept:
False
azurefs_update_interval:
60
cache:
localfs
cache_sreqs:
True
cachedir:
/var/cache/salt/master
clean_dynamic_modules:
True
cli_summary:
False
client_acl_verify:
True
cluster_mode:
False
con_cache:
False
......
pillar自定义数据:
在master的配置文件里找pillar_roots可以看到其存放pillar的位置
vim /etc/salt/master
...省略N行
##### Pillar settings #####
##########################################
# Salt Pillars allow for the building of global data that can be made selectively
# available to different minions based on minion grain filtering. The Salt
# Pillar is laid out in the same fashion as the file server, with environments,
# a top file and sls files. However, pillar data does not need to be in the
# highstate format, and is generally just key/value pairs.
pillar_roots:
base:
- /srv/pillar/base
[root@master ~]# mkdir -p /srv/pillar/base
[root@master ~]# systemctl restart salt-master
[root@master ~]# vim /srv/pillar/base/web.sls
top.sls web.sls
[root@master ~]# cat /srv/pillar/base/web.sls
{% if grains['os'] == 'RedHat' %}
web: httpd
{% elif grains['os'] == 'CentOS' %}
web: nginx
{% endif %}
[root@master ~]# vim /srv/pillar/base/top.sls
base: //指定环境
'master': //指定目标
- web //引用install_a or install_n
[root@master ~]# salt '*' pillar.items
master:
----------
web:
httpd
node3:
----------
node2:
----------
node4:
----------
在salt下修改apache的状态文件,引用pillar的数据
[root@master ~]# cat /srv/salt/base/web/apache/install_a.sls
apache-install:
pkg.installed:
- name: {{ pillar['web'] }}
apache-service:
service.running:
- name: {{ pillar['web'] }}
- enable: True
查看top.sls文件
[root@master ~]# cat /srv/salt/base/top.sls
base:
master:
- web.apache.install_a
执行高级状态文件
[root@master ~]# salt 'master' state.highstate
master:
----------
ID: apache-install
Function: pkg.installed
Name: httpd
Result: True
Comment: The following packages were installed/updated: httpd
Started: 17:04:17.437885
Duration: 25946.149 ms
Changes:
----------
apr:
----------
new:
1.6.3-11.el8
old:
apr-util:
----------
new:
1.6.1-6.el8
old:
apr-util-bdb:
----------
new:
1.6.1-6.el8
old:
apr-util-openssl:
----------
new:
1.6.1-6.el8
old:
centos-logos-httpd:
----------
new:
85.8-1.el8
old:
httpd:
----------
new:
2.4.37-39.module_el8.4.0+950+0577e6ac.1
old:
httpd-filesystem:
----------
new:
2.4.37-39.module_el8.4.0+950+0577e6ac.1
old:
httpd-tools:
----------
new:
2.4.37-39.module_el8.4.0+950+0577e6ac.1
old:
mailcap:
----------
new:
2.1.48-3.el8
old:
mod_http2:
----------
new:
1.15.7-3.module_el8.4.0+778+c970deab
old:
----------
ID: apache-service
Function: service.running
Name: httpd
Result: True
Comment: Service httpd has been enabled, and is running
Started: 17:04:43.422896
Duration: 1558.777 ms
Changes:
----------
httpd:
True
Summary for master
------------
Succeeded: 2 (changed=2)
Failed: 0
------------
Total states run: 2
Total run time: 27.505 s
Grains与Pillar的区别
存储位置 | 类型 | 采集方式 | 应用场景 | |
---|---|---|---|---|
Grains | minion | 静态 | minion启动时采集 可通过刷新避免重启minion服务 | 1.信息查询 2.在命令行下进行目标匹配 3.在top file中进行目标匹配 4.在模板中进行目标匹配 |
Pillar | master | 动态 | 指定,实时生效 | 1.目标匹配 2.敏感数据配置 |