在一<a href="https://www.361way.com/saltstack-grains/5104.html" target="_blank" rel="noopener">上篇中</a>了解了saltstack的grains组件,本篇继续研究pillar组件。grains用于存储静态不易变更的数据,而pillar一般用来存储动态的、敏感的数据;通过minion端和master端都可以配置设置或获取grains信息,而pillar信息只能在master端配置,再到minion端执行。pillar默认使用sls文件进行数据存储(YAML格式),除此之外,pillar也同时支持多种后端的数据存储方式。例如:mysql, mongodb, ldap, json, cobbler甚至是puppet。这无疑为开发中的接口提供了极大的便利。
一、pillar使用场景和常用命令
1、pillar常用的场景
a、敏感数据:例如ssh key,加密证书等,由于pillar使用独立的加密session,可以确保这些敏感数据不被其他minion看到;
b、不同变量:可以在pillar中处理平台差异性,比如针对不同的操作系统设置软件包的名字,然后在state中引用;
c、用户版本等变量:可以在pillar中添加任何需要用到的数据,比如定义用户和UID的对应关系、软件版本和端口、minion的角色等等。
<br />
2、常用命令
<br />
salt '*' sys.doc pillar //查看与pillar有关的帮助信息
salt '*' pillar.items //获取所有pillar items值
salt '*' pillar.data //等价于pillar.items
salt '*' saltutil.refresh_pillar //刷新pillar值
salt '*' saltutil.sync_all //刷新pillar值,与refresh_pillar操作类似,但范围更大
salt '*' sys.list_functions pillar //列出所有的pillar相关函数方法
salt '*' pillar.get xxx //获取某项的值
salt '*' pillar.raw //内存中获取
<br />
二、使用pillar存储软件版本端口信息
默认pillar使用的目录是/srv/pillar/,如果想要使用其他目录需要在master上的/etc/salt/master配置文件中修改路径。默认的主入口配置文件是top.sls ,具体结构如下:
<br />
[root@itohost ~]# tree /srv/
/srv/
└── pillar
├── packages.sls
├── services.sls
└── top.sls
对应的文件内容如下:
<br />
[root@itohost pillar]# cat top.sls
base:
'*':
- packages
- services
[root@itohost pillar]# cat packages.sls
zabbix:
package-name: zabbix
version: 2.2.4
[root@itohost pillar]# cat services.sls
zabbix:
port: 10050
user: admin
top.sls引用时可以用两种方法:可以将引用文件放在同级,上面使用的就是这种;另一种是是在pillar目录下创建packages 、services目录,在该目录下创建init.sls文件。第二种用法,对应的目录结构如下:
<br />
[root@itohost mnt]# tree
.
└── pillar
├── packages
│ └── init.sls
├── services
│ └── init.sls
└── top.sls
<img src="https://www.361way.com/wp-content/uploads/2014/04/pillar-items.png" width="405" height="407" title="salt-pillar" alt="salt-pillar" />
<br />
三、根据操作系统版本进行包安装
还是同样在/srv/pillar目录下,我们修改刚刚的sls文件,具体如下:
<br />
#top.sls文件内容
[root@itohost pillar]# cat top.sls
base:
'*':
- packages
#引用的packages.sls文件的内容
[root@itohost pillar]# cat packages.sls
pkgs:
{% if grains['os'] == 'CentOS' %}
apache: httpd
git: git
{% elif grains['os'] == 'SUSE' %}
apache: apache2
git: git-core
{% endif %}
执行后获取的结果如下:
<br />
[root@itohost pillar]# salt '*' pillar.items
ZJHZ-BMC-test252-BJ:
----------
pkgs:
----------
apache:
apache2
git:
git-core
ZJHZ-CMREAD-YUM01-VINT-SD:
----------
pkgs:
----------
apache:
httpd
git:
git
也可以单独调用一个子值,如下:
<br />
[root@itohost pillar]# salt '*' pillar.item pkgs:apache
ZJHZ-BMC-test252-BJ:
----------
pkgs:apache:
apache2
ZJHZ-CMREAD-YUM01-VINT-SD:
----------
pkgs:apache:
httpd
这里的使用就比较有意思,先是通过Jinja模板写的sls(获取zabbix版本端口用的是YAML模块),然后通过操作系统的不同利用grains获pillar信息 。同样在state组件里也可以更方便的调用pillar,如下示例通过state组件可以方便的进行apache安装:
<br />
apache:
pkg.installed:
- name: {{ pillar['pkgs']['apache'] }}
对于上面的state sls文件还可以再进一步优化,设置默认值,如下:
<br />
apache:
pkg.installed:
- name: {{ salt['pillar.get']('pkgs:apache', 'httpd') }}
state组件后面还会再提及到,这里只简要说明下。
四、敏感数据密码信息
这里以mysql 的用户、密码及库名为例 ,如下:
<br />
# cat /srv/pillar/database.sls
dbname: project
dbuser: username
dbpass: password
dbhost: localhost
在模块文件中引用是,就可以像如下进行引用:
<br />
# cat website.conf
// MySQL settings
define('DB_NAME', '{{ pillar['dbname'] }}');
// MySQL database username
define('DB_USER', '{{ pillar['dbuser'] }}');
// MySQL database password
define('DB_PASSWORD', '{{ pillar['dbpass'] }}');
// MySQL hostname
define('DB_HOST', '{{ pillar['dbhost'] }}');
由于模板也是后面要提到的内容,后面还会提到。这里先有个概念。
五、总结
pillar在saltstack里是比较重要的一个组件,其可以用在模块里面,jinja模板里面,state的sls文件里面。除此之外,其还支持通过ext_pillar进行扩展。
ext_pillar:<span style="line-height:1.5;">除了上面提到的之外,pillar还支持通过mysql、redis、mongodb等扩展获取。这里给一个mysql 的示例:</span><a href="http://salt-private.readthedocs.io/en/latest/ref/pillar/all/salt.pillar.mysql.html" target="_blank" rel="noopener">http://salt-private.readthedocs.io/en/latest/ref/pillar/all/salt.pillar.mysql.html</a>
<br />
<br />