《SaltStack技术入门与实践》—— Grains

Posted zuoyang

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了《SaltStack技术入门与实践》—— Grains相关的知识,希望对你有一定的参考价值。

Grains

本章节参考《SaltStack技术入门与实践》,感谢该书作者: 刘继伟、沈灿、赵舜东

  前几章我们已经了解SaltStack各个组件以及通过一个案例去熟悉它的各种应用,从这章开始我们通过Python语言去扩展SaltStack组件。虽然SaltStack自带的各种组件在功能上已经很成熟了,但是有时候无法满足企业各种复杂的环境。本章的主要内容就是如何去扩展SaltStack各个组件。

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

[[email protected] ~]# 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查看,如下:

[[email protected] ~]# salt ‘irora200‘ sys.doc grains

二、获取主机item信息

2.1、查看可以获取的items项

[[email protected] ~]# 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
    ………………省略

2.2、查看所有的itmes项

[[email protected] ~]# 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 一一对应,输出结果较上面更详细。

 2.3、查看某项或多项item值

[[email protected] ~]# salt ‘irora200‘ grains.item ipv4
www.361way.com:
    ----------
    ipv4:
        - 10.211.1.10
        - 127.0.0.1
        - 192.168.0.222
# 一次查看多项
[[email protected] ~]# salt ‘irora200‘ grains.item os osrelease osfinger
www.361way.com:
    ----------
    os:
        RedHat
    osfinger:
        Red Hat Enterprise Linux Server-6
    osrelease:
        6.6

  默认定义好的Granis 的取值可以参看salt grains core.py文件

三、自定义Grains

  三种自定义Grains的方法,这里一一说明下:

  1. 通过Minion配置文件配置
  2. 通过Grains模块定义Grains
  3. 使用自定义python脚本获取grains信息

3.1、通过Minion配置文件配置

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

[[email protected] ~]# cat /etc/salt/minion.d/grains.conf
grains:
roles:
- webserver
- memcache
deployment: datacenter4
cabinet: 13
cab_u: 14-15

  配置增加完成后重启salt-minion服务生效。通过saltmaster端查看结果如下: 

[[email protected] ~]# salt ‘irora200‘ grains.item roles
www.361way.com:
----------
roles:
- webserver
- memcache

  这里有两点一定需要注意:1、grains.conf 里的配置需要是YAML格式2、配置修改后需要重启salt-minion服务才能生效

3.2、通过Grains模块定义Grains

  上面使用list_functions 列出所有的函数时,对应的是有grains.append、grains.setval等方法,这里就是利用该方法进行的操作。示例如下:

[[email protected] ~]# salt ‘irora200‘ grains.append hosttype ‘online‘
irora200:
----------
hosttype:
- online
[[email protected] ~]# salt ‘irora200‘ grains.item hosttype
irora200:
----------
hosttype:
- online
[[email protected] ~]# salt ‘irora200‘ grains.setvals "{‘idc‘:‘ZJ‘,‘city‘:‘hangzhou‘}"
irora200:
----------
city:
hangzhou
idc:
ZJ
[[email protected] ~]# salt ‘irora200‘ grains.item idc city
irora200:
----------
city:
hangzhou
idc:
ZJ

  这样配置后,会在minion主机端生成配置文件grains ,如下:

[[email protected] 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)。

技术分享图片

  所以会上例中不难看出,/etc/salt/minion.d/grains.conf (或/etc/salt/minion)  > /etc/salt/grains配置中的优先级。

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

四、扩展Grains

  在前面我们已经了解了Grains组件的相关知识,在SaltStack案例章节中也了解了如何去使用它。虽然Grains呢个收集得到minion的各种静态信息,但是为了满足更加复杂应用,系统Grains能根据我们的需求去采集一些信息,例如在大批量机器中我们区分每台机器的业务角色,这个时候我们就可以自定义一个Grains,让Minion通过外部数据(CMDB)去采集自己的业务汇报给Master。在大规模的配置中我们就可以利用这个Grains去更加方便地管理配置各个角色的设备。

4.1、理解扩展Grains流程

  首先我们了解扩展Grains流程。第1步,我们需要在Master上编写一个Python脚本。这个脚本的主要内容就是去定义如何收集你想要的信息。在脚本的最后把采集到的各种信息返回。第2步,需要把这个脚本sync同步到所有的Minions上。如果你采用前面章节使用的静态文件Grains同步方式,接下来我们重启Minions服务。因为sync同步Griains脚本的时候Minion就会去采集刷新Grains。所以我们这里就不需要重启Minions服务就可以收集到最新的Grains值了。

下面我们来看一个例子:

[[email protected] ~]# cat /srv/salt/_grains/example.py
#!/usr/bin/env python
def grains():
    local = {}
    test = { key1: value1, key2: value2, key3: value3 }
    local[list] = [1,2,3,4]
    local[string] = str
    local[dict] = test
    return local

  下面我们把这个脚本同步到minion上去:

[[email protected] salt]# salt ‘salt-minion-1‘ saltutil.sync_grains

  然后我们可以去Minion上查看这个脚本,这个脚本会同步到Minion配置文件里面定义的cachedir目录extmods/grains下:

[[email protected] salt]# salt ‘salt-minion-1‘ cmd.run ‘ls /var/cache/salt/minion/extmods/grains/‘

  如果你想在Master上查看使用脚本定义的Grains信息,可以通过如下命令:

[[email protected] salt]# salt ‘salt-minion-1‘ grains.item list string dict

4.2、扩展Grains案例

  下面我们通过一个我曾经在实际工作中使用的自定义Grains案例吧。下面案例的内容可能对大家工作中没多大影响。这里引入这个案例只是为了大家能更好低理解扩展Grains的流程:

cat /srv/salt/_grains/get_time.py
#!/usr/bin/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主机上去
salt * saltutil.sync_grains
salt * grains.item server_time

  执行同步命令后,自定义脚本会上传到minion的/var/cache/salt/minion/extmods/grains目录下。

五、总结

  1. grains组件在saltstack中是一个非常重要的组件,我们执行的时候主机的正则匹配,主机端信息的获取等都会用到该组件 。不过grains也有自身的局限性,就是主要存储静态数据,后面还会提到另一个组件pillar ,两者可以做一个很好的互补;
  2. 能过了解grains三个自定义方式的优化级配置,我们可以根据需要定义在哪一个文件中指定什么信息;
  3. 在/srv/salt/_grains目录下的自定义脚本,在执行完成后,强烈建议移到一个bak目录下。使该目录下是没有文件,并且再执行一次salt ‘*‘ saltutil.sync_grains操作。使minion主机上自定义模块目录是干净的,这样做的好处是可以避免和另外两个文件有配置冲突,也避免脚本之间有重复的名字定义,造成取回的结果不对。

以上是关于《SaltStack技术入门与实践》—— Grains的主要内容,如果未能解决你的问题,请参考以下文章

saltstack应用实战

dW 编辑推荐:自动化运维工具 SaltStack 在云计算环境中的实践

saltstack 数据系统之 grains 简单学习

带你快速入门SaltStack

SaltStack入门

saltstack安装部署与入门使用