Saltstack自动化(三)Grains组件

GRAINS 组件是saltstack中非常重要的一个组件,其主要用于记录Minion的一些静态信息,如比:CPU、内存、磁盘、网络等。<span style="color:#E56600;">grains信息是每次客户端启动后自动上报给master的,一旦这些静态信息发生改变需要重启minion 或者 重新同步下 grains</span>。除此之外我们还可以自定义Grains的一些信息。自定义的方法有三种:1、通过Minion配置文件定义;2、通过Grains相关模块定义;3、通过python脚本定义。

一、利用grains获取信息

1、查看Grains相关的命令及用法

<br />
[root@saltmaster ~]# salt 'irora200' sys.list_functions grains
www.361way.com:
    - grains.append
    - grains.delval
    - grains.fetch
    - grains.filter_by
    - grains.get
    - grains.get_or_set_hash
    - grains.has_value
    - grains.item
    - grains.items
    - grains.ls
    - grains.remove
    - grains.set
    - grains.setval
    - grains.setvals
每个命令的帮助信息又可以通过sys.doc查看,如下:



<br />
[root@saltmaster ~]# salt 'irora200' sys.doc grains
输出比较多,这里就不再粘出。

2、获取主机item信息

<strong>2.1、查看可以获取的items项</strong>



<br />
[root@saltmaster ~]# salt 'irora200' grains.ls
www.361way.com:
    - SSDs
    - biosreleasedate
    - biosversion
    - cpu_flags
    - cpu_model
    - cpuarch
    - disks
    - dns
    - domain
    - fqdn
    - fqdn_ip4
    - fqdn_ip6
    - gid
    - gpus
    - groupname
    ………………省略
<strong>2.2、查看所有的itmes项</strong>
[root@saltmaster ~]# salt 'irora200' grains.items
www.361way.com:
    ----------
    SSDs:
    biosreleasedate:
        01/01/2011
    biosversion:
        0.5.1
    cpu_flags:
        - fpu
        - de
        - pse
        ……… 省略
   cpu_model:
        Intel Xeon E312xx (Sandy Bridge)
    cpuarch:
        x86_64
        ……… 省略
这里的输出是上面grains.ls 一一对应,输出结果较上面更详细。



<strong>2.3、查看某项或多项item值</strong>



<br />
[root@saltmaster ~]# salt 'irora200' grains.item ipv4
www.361way.com:
    ----------
    ipv4:
        - 10.211.1.10
        - 127.0.0.1
        - 192.168.0.222
# 一次查看多项
[root@saltmaster ~]# salt 'irora200' grains.item os osrelease osfinger
www.361way.com:
    ----------
    os:
        RedHat
    osfinger:
        Red Hat Enterprise Linux Server-6
    osrelease:
        6.6
默认定义好的Granis 的取值可以<a href="https://github.com/saltstack/salt/blob/develop/salt/grains/core.py" target="_blank" rel="noopener">参看salt grains core.py文件</a>。

二、自定义Grains

在开头我们提到三种自定义Grains的方法,这里一一说明下。

1、通过Minion配置文件配置

在Minion端我们可以通过查看/etc/salt/minion配置文件中,查找grains可以查看到相关注释的示例。不过便于配置管理,我们不一般不会选择在该文件上进行修改,而在minion include的目录下/etc/salt/minion.d目录下单独创建grains.conf文件。就以官方给出的示例,将minion配置文件中配置示例复到/etc/salt/minion.d/grains.conf中,并将注释去掉,如下:



<br />
[root@361way.com ~]# cat /etc/salt/minion.d/grains.conf
grains:
  roles:
    - webserver
    - memcache
  deployment: datacenter4
  cabinet: 13
  cab_u: 14-15
配置增加完成后重启salt-minion服务生效。通过saltmaster端查看结果如下:



<br />
[root@saltmaster ~]# salt 'irora200' grains.item roles
www.361way.com:
    ----------
    roles:
        - webserver
        - memcache
这里有两点一定需要注意:<span style="background-color:#FFE500;">1、grains.conf 里的配置需要是YAML格式;2、配置修改后需要重启salt-minion服务才能生效</span>。

2、通过Grains模块定义Grains

上面使用list_functions 列出所有的函数时,对应的是有grains.append、grains.setval等方法,这里就是利用该方法进行的操作。示例如下:
[root@saltmaster ~]# salt 'irora200' grains.append hosttype 'online'
irora200:
    ----------
    hosttype:
        - online
[root@saltmaster ~]# salt 'irora200' grains.item hosttype
irora200:
    ----------
    hosttype:
        - online
[root@saltmaster ~]# salt 'irora200' grains.setvals "{'idc':'ZJ','city':'hangzhou'}"
irora200:
    ----------
    city:
        hangzhou
    idc:
        ZJ
[root@saltmaster ~]# salt 'irora200' grains.item idc city
irora200:
    ----------
    city:
        hangzhou
    idc:
        ZJ
这样配置后,会在minion主机端生成配置文件grains ,如下:



<br />
[root@irora200 salt]# cat /etc/salt/grains
city: hangzhou
hosttype:
- online
idc: ZJ
如下图所示,我们做了一个实验,如果/etc/salt/minion.d/grains.conf中已经存在的自定义items ,再通过执行grains.append 或 grains.setval 去执行时,发现会以grains.conf中的为准,虽然在/etc/salt/grains中也有内容生成。而且执行grains.append操作后,/etc/salt/minion.d/grains.conf中已存在的值会覆盖/etc/salt/grains中的重复值。即下例中deployment的值在/etc/salt/grains中的变化为datacenter1(setval操作后) --datacenter4(append操作后,并没有变成datacenter5)。



<br />



<img src="https://www.361way.com/wp-content/uploads/2014/04/grains.png" width="604" height="279" title="saltstack grains" alt="saltstack grains" />



所以会上例中不难看出,<span style="background-color:#FFE500;">/etc/salt/minion.d/grains.conf (或/etc/salt/minion) &nbsp;> /etc/salt/grains配置中的优先级</span>。



注:<span style="color:#E53333;">该处也适用通过分发文件到minion的/etc/salt/grains ,不过分发文件和命令执行的区别是,分发文件必须要minion端重启salt-minion服务后才能生效。而通过grains 命令执行是立即生效的</span>。

3、使用自定义python脚本获取grains信息

<strong>示例1:获取主机系统时间</strong>



默认自定义脚本需要存放在master的/srv/salt/_grains目录下,这里使用mkdir -p创建即可。这里一个获取系统时间的脚本内容如下:



<br />
[root@saltmaster _grains]# cat get_time.py
#!/usr/bin/env python
# coding=utf-8
from datetime import datetime
def get_server_time():
    grains = {}
    grains['server_time'] = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    return grains
使用sync_grains命令同步脚本到minion主机上去,并通过grains.item命令获取相关信息即可,如下:



<br />
[root@saltmaster _grains]# salt '*' saltutil.sync_grains
serverb.pod0.example.com:
    - grains.get_time
irora200:
    - grains.get_time
[root@saltmaster _grains]# salt '*' grains.item server_time
serverb.pod0.example.com:
    ----------
    server_time:
        2014-04-02 23:53:23
irora200:
    ----------
    server_time:
        2014-04-02 15:53:23
执行同步命令后,自定义脚本会上传到minion的/var/cache/salt/minion/extmods/grains目录下。



<br />
[root@irora200 grains]# ls
get_time.py  get_time.pyc
[root@irora200 grains]# pwd
/var/cache/salt/minion/extmods/grains
<strong>示例2:对比自定义python脚本与前两者的优先级</strong>



脚本内容:



<br />
[root@saltmaster _grains]# more info.py
#!/usr/bin/python2.6
import os,commands,math
def info():
  fc = {}
  #fc['disks'] = commands.getoutput('df -m| grep "/dev/sda1" | awk \' { print NF } \' ')
  #fc['disk_size'] = commands.getoutput('df -m| grep "/dev/sda1" | tail -n 1 | awk \' { print2 } \' ')
  #fc['disk_size_per'] = int(math.floor(float(fc['disk_size'])/100000))*1000
  fc['node'] = commands.getoutput('hostname | cut -c1-8')
  fc['deployment'] = 'datacenter1'
  fc['nets'] = commands.getoutput('ifconfig  | awk \' BEGIN { FS=":| +"; } /inet addr/ { print 4 } \' | awk  \'BEGIN { FS=".";OFS="." }  { print1,2,3,"0/24" } \'
')
  return fc
同步后,执行的结果如下:



<br />
[root@saltmaster _grains]# salt '*' saltutil.sync_grains
serverb.pod0.example.com:
    - grains.info
irora200:
    - grains.info
[root@saltmaster _grains]# salt 'irora200' grains.item node
irora200:
    ----------
    node:
[root@saltmaster _grains]# salt 'irora200' grains.item node deployment
irora200:
    ----------
    deployment:
        datacenter4
    node:
        irora200
这里需要注意的是,脚本如果有问题,是无法正常获取结果的。由于被测试的主机irora200是台kvm虚拟机,使用的磁盘是vda,所以上面关于磁盘的部分有问题,这样执行会出错,可以看出第一次取node的结果是空,也就是失败的。将脚本关于磁盘的部分注释后,我再取结果,发现deployment的结果还是这之前datacenter4,可见是优先级是第于/etc/salt/minion.d/grains.conf中的配置的。



再对比下自定义脚本和/etc/salt/grains的优先级,将/etc/salt/minion.d/grains.conf中的配置取消,重启salt-minion服务。对比结果如下:



<br />
[root@irora200 grains]# sed -i '/deployment/d' /etc/salt/minion.d/grains.conf
[root@irora200 grains]# /etc/init.d/salt-minion restart
Stopping salt-minion daemon:                               [  OK  ]
Starting salt-minion daemon:                               [  OK  ]
[root@irora200 grains]# cat /etc/salt/grains
city: hangzhou
deployment: datacenter4
hosttype:
- online
idc: ZJ
[root@saltmaster _grains]# salt 'irora200' grains.item node deployment nets
irora200:
    ----------
    deployment:
        datacenter1
    nets:
        192.168.0.0/24
        10.211.1.0/24
        127.0.0.0/24
    node:
        irora200
可以看出,<span style="color:#E53333;">grains配置优先级顺序为/etc/salt/minion.d/grains.conf (或/etc/salt/minion) > master端自定义grains脚本(minion端/var/cache/salt/minion/extmods/grains目录下) >&nbsp;Grains模块定义Grains (/etc/salt/grains) </span>。

三、总结

1、grains组件在saltstack中是一个非常重要的组件,我们执行的时候主机的正则匹配,主机端信息的获取等都会用到该组件 。不过grains也有自身的局限性,就是主要存储静态数据,后面还会提到另一个组件pillar ,两者可以做一个很好的互补;



2、能过了解grains三个自定义方式的优化级配置,我们可以根据需要定义在哪一个文件中指定什么信息;



3、在/srv/salt/_grains目录下的自定义脚本,在执行完成后,强烈建议移到一个bak目录下。使该目录下是没有文件,并且再执行一次salt '*' saltutil.sync_grains操作。使minion主机上自定义模块目录是干净的,这样做的好处是可以避免和另外两个文件有配置冲突,也避免脚本之间有重复的名字定义,造成取回的结果不对。



<br />

Saltstack自动化(三)Grains组件》有1条评论

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注