saltstack中grains详解

一、grains简介

(1) Grains是SaltStack的一个组件，存放在SaltStack的minion端。
(2) 当salt-minion启动时会把收集到的数据静态存放在Grains当中，只有当minion重启时才会进行数据的更新。
(3) 由于grains是静态数据，因此不推荐经常去修改它。

1.应用场景：
信息查询，可用作CMDB。
在target中使用，匹配minion。
在state系统中使用，配置管理模块。

2.信息查询

用于查询minion端的IP、FQDN等信息。

(1)默认可用的grains：

salt '*' grains.ls	

(2)查看每一项的值:

salt '*' grains.items	##查询所有

(3) 取单项的值:

salt server2 grains.item ipv4
salt server3 grains.item fqdn
salt '*' grains.item nodename

二、自定义grains项

1.在server2:/etc/salt/minion中定义：

vim /etc/salt/minion	##修改配置文件
grains:
  roles:
    - apache
##重启salt-minion，否则数据不会更新： 
systemctl  restart salt-minion

查看:

salt server2  grains.item roles

2.在server3:/etc/salt/grains中定义:

vim /etc/salt/grains	
roles: nginx

同步数据：
方法1：

## minion端：重启salt-minion
systemctl  restart salt-minion

查询自定义项：

salt server3 grains.item roles

方法2：

## master端
salt server3 saltutil.sync_grains

查询自定义项：

salt server3 grains.item roles

3.在salt-master端创建_grains目录：

mkdir /srv/salt/_grains
vim /srv/salt/_grains/my_grain.py
def my_grain()
    grains = {}
    grains['roles'] = nginx
    grains['hello'] = 'world'
    return grains
    
#同步grains到minion端
salt '*' saltutil.sync_grains	

查询自定义项：

salt server3 grains.item roles