saltstack数据系统Grains

1.什么是Grains系统

Grains是SaltStack收集的有关底层管理系统的静态信息。 SaltStack收集的Grains信息包括操作系统版本、域名、IP地址、内核、操作系统类型、内存以及许多其他系统属性。
您可以将自定义的grains添加到Salt Minion的/etc/salt/grains文件中，或放置在Grains部分下的Salt Minion配置文件中。 例如，许多用户为每个Salt Minion添加一个称为角色的定制grain来描述系统的功能。

2.利用grains获取信息

2.1 查看Grains拥有那些函数

[root@localhost]# salt "agent1" sys.list_functions grains
agent1:
    - grains.append
    - grains.delkey
    - grains.delval
    - grains.equals
    - 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查看，如下：
[root@localhost]# salt 'agent1' sys.doc grains

2.2 获取主机item信息

[root@localhost salt]# salt '*' grains.ls
agent1:
    - SSDs
    - biosreleasedate
    - biosversion
    - cpu_flags
    - cpu_model
    - cpuarch
    - disks
    - dns
    - domain
    - fqdn
    - fqdn_ip4
    - fqdn_ip6
    - fqdns
    - gid
    ......

查看item的详细信息

[root@localhost salt]# salt '*' grains.items
agent1:
    ----------
    SSDs:
    biosreleasedate:
        04/13/2018
    biosversion:
        6.00
    cpu_flags:
        - fpu
        - vme
        - de
        - pse
        - tsc
        - msr
        ......  
        # 此处显示还有很多
    cpu_model:
        Intel(R) Core(TM) i5-8500 CPU @ 3.00GHz
    cpuarch:
        x86_64
    disks:
        - sda
        - sr0
        - dm-0
        - dm-1
    ......

查看某项或多项item值

[root@localhost salt]# salt '*' grains.item ipv4
agent1:
    ----------
    ipv4:
        - 127.0.0.1
        - 192.168.1.4
        
[root@localhost salt]# salt '*' grains.item localhost ipv4
agent1:
    ----------
    ipv4:
        - 127.0.0.1
        - 192.168.1.4
    localhost:
        wang

2.3 通过Grains模块定义Grains

方式一：命令行操作

[root@localhost salt]# salt 'agent1' grains.append hosttype 'redis-slave'
agent1:
    ----------
    hosttype:
        - redis-slave
[root@localhost salt]# salt '*' grains.item hosttype
agent1:
    ----------
    hosttype:
        - redis-slave
[root@localhost salt]# salt 'agent1' grains.setvals "{'city':'beijing'}"
agent1:
    ----------
    city:
        beijing
[root@localhost salt]# salt '*' grains.item city
agent1:
    ----------
    city:
        beijing

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

[root@wang ~]# cat /etc/salt/grains
city: beijing
hosttype:
- redis-slave

方式二：
1.在配置文件中操作(minion端)

• /etc/salt/minion.d/grains.conf
• /etc/salt/minion
• /etc/salt/grains

在三个文件中配置都会生效，这里在/etc/salt/minion中配置
# Custom static grains for this minion can be specified here and used in SLS
# files just like all other grains. This example sets 4 custom grains, with
# the 'roles' grain having two values that can be matched against.
#grains:
#  roles:
#    - webserver
#    - memcache
#  deployment: datacenter4
#  cabinet: 13
#  cab_u: 14-15
grains:
  roles: apache
  
在master节点查看item
[root@localhost salt]# salt 'agent1' grains.item roles
agent1:
    ----------
    roles:
        apache


注：如果/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中的重复值。
/etc/salt/minion.d/grains.conf (或/etc/salt/minion)  > /etc/salt/grains配置中的优先级。

配置文件中操作，重启客户端才会生效。修改/etc/salt/grains不重启服务的方法，刷新命令如下

salt '*' saltutil.sync_grains

参考链接：http://www.361way.com/saltstack-grains/5104.html

2.grains_module的方式设置(master端)

首先在master上建立模块对应的目录：
# mkdir -pv /srv/salt/_grains

然后写入一个简单模块

#vi /srv/salt/_grains/my_grain_mod.py 
import time 
def now():
    grains = {}
    grains['now'] = time.time() 
    return grains

然后同步模块到minion：

[root@localhost ~]# salt 'agent1' saltutil.sync_all
agent1:
    ----------
    beacons:
    clouds:
    engines:
    grains:
        - grains.my_grain_mod
    log_handlers:
    matchers:
    modules:
    output:
    proxymodules:
    renderers:
    returners:
    sdb:
    serializers:
    states:
    thorium:
    utils:

重新加载一次模块：

[root@localhost ~]# salt 'agent1' sys.reload_modules
agent1:
    True

查看新设置得Grains：

[root@localhost ~]# salt 'agent1' grains.item now
agent1:
    ----------
    now:
        1568104340.697266