Saltstack grains组件

　　grains是Saltstack最重要的组件之一，grains的作用是收集被控主机的基本信息，这些信息通常都是一些静态的数据，包括CPU、内核、操作系统、虚拟化等，在服务器端可以根据这些信息进行灵活定制，管理员可以利用这新信息对不同业务进行个性化配置。

官网提供的用来区分不同操作系统的示例如下(采用jinja模板):

{% if grains['os'] == 'Ubuntu' %}
host: {{ grains['host'] }}
{% elif grains['os'] == 'CentOS' %}
host: {{ grains['fqdn'] }}
{% endif %}

　　示例中CentOS发行版主机将被 "host: {{ grains['fqdn'] }}"匹配，以主机SN100-128(centOS6.4)为例，最终得到"host:SN100-128"。同时，命令行的匹配操作系统发行版本为CentOS的被控端可以通过-G参数来过滤，如salt -G 'os:CentOS' test.ping。

[root@localhost~]# salt -G 'os:CentOS' test.ping
SN100-128:
    True
SN100-129:
    True
SN100-130:
    True

(1) grains常用操作命令：

#获取主机的grains项信息：

[root@localhost~]# salt 'SN100-128' grains.ls
SN100-128:
    - SSDs
    - biosreleasedate
    - biosversion
    - cpu_flags
    - cpu_model
    - cpuarch
    - domain
    - fqdn
    - fqdn_ip4
    - fqdn_ip6
    - gpus
    - host
    - hwaddr_interfaces
    - id
    - init
    - ip4_interfaces
    - ip6_interfaces
    - ip_interfaces
    - ipv4
    - ipv6
    - kernel
    - kernelrelease
    - locale_info
    - localhost
    - lsb_distrib_codename
    - lsb_distrib_id
    - lsb_distrib_release
    - machine_id
    - manufacturer
    - master
    - mdadm
    - mem_total
    - nodename
    - num_cpus
    - num_gpus
    - os
    - os_family
    - osarch
    - oscodename
    - osfinger
    - osfullname
    - osmajorrelease
    - osrelease
    - osrelease_info
    - path
    - productname
    - ps
    - pythonexecutable
    - pythonpath
    - pythonversion
    - saltpath
    - saltversion
    - saltversioninfo
    - selinux
    - serialnumber
    - server_id
    - shell
    - virtual
    - zmqversion

获取主机单项grains数据：

 #获取操作系统发行版本.
[root@localhost~]# salt 'SN100-128' grains.item os
SN100-128:
    ----------
    os:
        CentOS
#获取操作系统的内核信息.
[root@localhost~]# salt 'SN100-128' grains.item kernel
SN100-128:
    ----------
    kernel:
        Linux

#获取操作系统的selinux信息
[root@localhost~]# salt 'SN100-128' grains.item selinux
SN100-128:
    ----------
    selinux:
        ----------
        enabled:
            False
        enforced:
            Disabled

#salt '*' grains.item os //返回键值对

#salt '*' grains.get os  //返回值

获取主机id为'SN100-128'的所有grains键及值信息。

[root@localhost~]# salt 'SN100-128' grains.items
SN100-128:
    ----------
    SSDs:
    biosreleasedate:
        04/14/2014
    biosversion:
        6.00
    cpu_flags:
        - fpu - vme  - de  - pse   - tsc - msr - pae - mce - cx8 - apic - sep - mtrr  - pge - mca - cmov - pat - pse36
    cpu_model:
        Intel(R) Xeon(R) CPU E5-2650 v3 @ 2.30GHz
    cpuarch:
        x86_64
    domain:
    fqdn:
        TestOnlyMPAPP
    fqdn_ip4:
        - 10.10.100.128
        - 127.0.0.1
    fqdn_ip6:
    gpus:
        |_
          ----------
          model:
              SVGA II Adapter
          vendor:
              unknown
    host:
        TestOnlyMPAPP
    hwaddr_interfaces:
        ----------
        eth1:
            00:50:56:87:b1:54
        lo:
            00:00:00:00:00:00
    id:
        SN100-128
    init:
        upstart
    ip4_interfaces:
        ----------
        eth1:
            - 10.10.100.128
        lo:
            - 127.0.0.1
    ip6_interfaces:
        ----------
        eth1:
            - fe80::250:56ff:fe87:b154
        lo:
            - ::1
    ip_interfaces:
        ----------
        eth1:
            - 10.10.100.128
            - fe80::250:56ff:fe87:b154
        lo:
            - 127.0.0.1
            - ::1
    ipv4:
        - 10.10.100.128
        - 127.0.0.1
    ipv6:
        - ::1
        - fe80::250:56ff:fe87:b154
    kernel:
        Linux
    kernelrelease:
        2.6.32-431.el6.x86_64
    locale_info:
        ----------
        defaultencoding:
            UTF8
        defaultlanguage:
            zh_CN
        detectedencoding:
            UTF-8
    localhost:
        TestOnlyMPAPP
    lsb_distrib_codename:
        Final
    lsb_distrib_id:
        CentOS
    lsb_distrib_release:
        6.5
    machine_id:
        bcc4f9ad2d40506966ce2b1400000014
    manufacturer:
        VMware, Inc.
    master:
        10.10.100.127
    mdadm:
    mem_total:
        8001
    nodename:
        TestOnlyMPAPP
    num_cpus:
        2
    num_gpus:
        1
    os:
        CentOS
    os_family:
        RedHat
    osarch:
        x86_64
    oscodename:
        Final
    osfinger:
        CentOS-6
    osfullname:
        CentOS
    osmajorrelease:
        6
    osrelease:
        6.5
    osrelease_info:
        - 6
        - 5
    path:
        /sbin:/usr/sbin:/bin:/usr/bin
    productname:
        VMware Virtual Platform
    ps:
        ps -efH
    pythonexecutable:
        /usr/bin/python2.6
    pythonpath:
        - /usr/bin
        - /usr/lib64/python26.zip
        - /usr/lib64/python2.6
        - /usr/lib64/python2.6/plat-linux2
        - /usr/lib64/python2.6/lib-tk
        - /usr/lib64/python2.6/lib-old
        - /usr/lib64/python2.6/lib-dynload
        - /usr/lib64/python2.6/site-packages
        - /usr/lib64/python2.6/site-packages/gst-0.10
        - /usr/lib64/python2.6/site-packages/gtk-2.0
        - /usr/lib64/python2.6/site-packages/webkit-1.0
        - /usr/lib/python2.6/site-packages
        - /usr/lib/python2.6/site-packages/setuptools-0.6c11-py2.6.egg-info
    pythonversion:
        - 2
        - 6
        - 6
        - final
        - 0
    saltpath:
        /usr/lib/python2.6/site-packages/salt
    saltversion:
        2015.5.8
    saltversioninfo:
        - 2015
        - 5
        - 8
        - 0
    selinux:
        ----------
        enabled:
            False
        enforced:
            Disabled
    serialnumber:
        VMware-42 07 95 36 bc 00 ee bd-bc 79 77 5c 81 14 35 b5
    server_id:
        295812205
    shell:
        /bin/sh
    virtual:
        VMware
    zmqversion:
        3.2.5

(2) 定义grains数据:

定义grains数据的方法有两种，其中一种为在被控端主机定制配置文件，另一种是通过主控端扩展模块API实现，区别是模块更灵活，可以通过python编程动态定义，而配置文件只适合相对固定的键与值。下面分别举例说明。

1.被控端主机定制grains数据

SSH登录一台被控主机，如SN100-128，配置文件定制的路径为/etc/salt/minion,参数为default_include: minion.d/*.conf，具体操作如下：

【/etc/salt/minion.d/hostinfo.conf】

grains:
 roles:
  - webserver
  - memcache
 deployment: datacenter4
 cabinet: 13

　　重启被控主机salt-minion服务，使之生效：service salt-minion restart。验证结果在主控端主机运行：salt 'SN100-128' grains.item roles deployment cabinet，观察配置的键与值，如下所示。

[root@localhost~]# salt 'SN100-128' grains.item roles deployment cabinet
SN100-128:
    ----------
    cabinet:
        13
    deployment:
        datacenter4
    roles:
        - webserver
        - memcache

或者也可以这样定义

vim /etc/salt/grains

cloud: openstack
test: salt

/etc/init.d/salt-minion restart 或者执行同步 salt '*' saltutil.sync_grains

salt -G 'cloud:openstack' test.ping

2.主控端扩展模块定制grains数据

　　首先在主控端编写python代码，然后将该python文件同步到被控主机，最后刷新生效(即编译python源码文件生成字节码pyc)。在主控端bash目录(见/etc/salt/master配置文件的file_roots项，默认的bash配置在/srv/salt)下生成_grains目录，执行install -d /srv/salt/_grains开始编写代码，实现获取被控主机系统允许最大打开文件数(ulimit -n)的grains数据。

【/srv/salt/_grains/sysprocess.py】

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

import os,sys,commands
def Granins_openfile():
        """
                os max open file of grains value
         """
        grains = {}
        #init default value
        _open_file=65535
        try:
                getulimit=commands.getstatusoutput('source /etc/profile;ulimit -n')
        except Exception,e:
                pass
        if getulimit[0] == 0:
                _open_file=int(getulimit[1])
        grains['max_open_file'] = _open_file
        return  grains
Granins_openfile()

上面代码的说明如下。

　grains_openfile()定义一个获取最大打开文件数的函数，函数名称没有要求，符合python的函数命名规则即可；

　grains = {} 初始化一个grains字典，变量名一定要用grains，以便Saltstack识别；

　grains['max_open_file'] = _open_file 将获取的linux ulimit -n 的结果值赋予grains['max_open_file'],其中"max_open_file"就是grains的项，_open_file就是grains的值。

　最后同步模块到指定被控端主机并刷新生效，因为grains比较合适采集静态类的数据，比如硬件，内核信息等。当有动态类的功能需求时，需要提行刷新，具体操作如下：

　　同步模块 salt 'SN100-128' saltutil.sync_all ，看看 "SN100-128"主机发生了什么？文件已经同步到minion cache目录中，如下：

/var/cache/salt/minion/extmods/grains/sysprocess.py
/var/cache/salt/minion/files/base/_grains/sysprocess.py

/var/cache/salt/minion/extmods/grains/为扩展模块文件最终存放位置，刷新模块后将在同路径下生成字节码pyc；

/var/cache/salt/minion/files/base/_grains/为临时存放位置。

 刷新模块salt 'SN100-128' sys.reload_modules，再看看主机发生了什么变化？在/var/cache/salt/minion/extmods/grains/位置多了一个编译后的字节码文件sysprocess.pyc文件，为python可执行的格式。

/var/cache/salt/minion/extmods/grains/sysprocess.py
/var/cache/salt/minion/extmods/grains/sysprocess.pyc
/var/cache/salt/minion/files/base/_grains/sysprocess.py

效验结果为可以在主控端查看grains信息，执行 salt 'SN100-128' grains.item max_open_file，结果显示"max_open_file:1024",这就是前面定制的主机grains信息。

[root@localhost~]# salt 'SN100-128' grains.item max_open_file
SN100-128:
    ----------
    max_open_file:
        1024

grains在top.sls中的使用：

'roles: nginx':
  - match:grain   //声明使用grain
  - init.pkg	  //执行init.pkg模块