grains

介绍：
　　作为获取系统底层信息的一个接口，可收集大量的系统基础信息。
　　salt master可以通过grains获取minion端的具体信息，从而进行差异化的处理。
　　grains保存的是一个相对静态的数据，可以配置为定时刷新的方式。
　　grains不区分变量的大小写。

---

LISTING GRAINS

列出grains变量，master端执行
　　salt '*' grains.ls
　　salt '*' grains.items

---

GRAINS IN THE MINION CONFIG

在minion配置grains变量，可以使用以下几种方法：
（1）在minion的主配置文件中配置

grains:
  roles:
    - webserver
    - memcache
  deployment: datacenter4
  cabinet: 13
  cab_u: 14-15

 （2）配置在单独的文件中,不需要顶层的grains

cat /etc/salt/grains
roles:
  - webserver
  - memcache
deployment: datacenter4
cabinet: 13
cab_u: 14-15

---

MATCHING GRAINS IN THE TOP FILE

在minion中正确的配置好grains之后，就可以在pillar的top文件中配置匹配grains
示例：

'node_type:webserver':
  - match: grain
  - webserver

'node_type:postgres':
  - match: grain
  - postgres

'node_type:redis':
  - match: grain
  - redis

'node_type:lb':
  - match: grain
  - lb

优化版示例：

{% set the_node_type = salt['grains.get']('node_type', '') %}

{% if the_node_type %}
  'node_type:{{ the_node_type }}':
    - match: grain
    - {{ the_node_type }}
{% endif %}

说明：使用模板的方式比上面类似硬编码的方式要简略些，可以根据实际grains变量的值进行渲染，但是一定要确认好minion端设置了node_type

---

WRITING GRAINS

步骤：
（1）在file_roots里设置环境路径
　　/srv/salt/_grains
（2）在定义好的grains目录下编写自定义的函数
　　示例：

def yourfunction():
     # initialize a grains dictionary
     grains = {}
     # Some code for logic that sets grains like
     grains['yourcustomgrain'] = True
     grains['anothergrain'] = 'somevalue'
     return grains
     #函数名无所谓，确保返回的为python字段类型即可

---

WHEN TO USE A CUSTOM GRAIN

如何使用自定义的grains

出发点：如果存储的数据经常变更的话优先考虑将数据定义在pillar中。
在jinja模板中使用自定义的grains：

    ...
    ...
    {{ salt['module.function_name']('argument_1', 'argument_2') }}
    {{ pillar['my_pillar_key'] }}
    ...
    ... 

---

LOADING CUSTOM GRAINS

如何加载自定义的grains文件，使用main函数的方式

示例：

#!/usr/bin/env python
def _my_custom_grain():
    my_grain = {'foo': 'bar', 'hello': 'world'}
    return my_grain


def main():
    # initialize a grains dictionary
    grains = {}
    grains['my_grains'] = _my_custom_grain()
    return grains

---

PRECEDENCE

minion端读取grains变量的优先级
1、Core grains.
　　核心的grains变量，包含系统的一些环境信息
2、Custom grains in /etc/salt/grains.
　　在/etc/salt/grains中编写的一些grains变量
3、Custom grains in /etc/salt/minion.
　　在minion主配置文件中编写的grains变量
4、Custom grain modules in _grains directory, synced to minions.
　　从master的_grains目录同步到minion端的grains变量

---

EXAMPLES OF GRAINS

参考：https://github.com/saltstack/salt/blob/develop/salt/grains/core.py

---

SYNCING GRAINS

同步grains变量，当以下命令被执行的时候被触发：
　　state.highstate
　　saltutil.sync_grains
　　saltutil.sync_all

---