Pillar Walkthrough

转自：http://wiki.saltstack.cn/topics/tutorials/pillar

• 转载地址： http://blog.csdn.net/qingchn/article/details/8753542

• 译者：葱油拌面

• 官方原文：http://docs.saltstack.com/topics/tutorials/pillar.html

Note

阅读这份手册之前，假定读者已经完成了Salt Stack基础 手册的阅读。

Pillar接口是Salt众多组件中最重要的部署组件，Pillar被用来为特别的从服务器生成特定数据的接口。在Pillar中生成的数据提供给所有的Salt组件并且被用来一下目的：

高度敏感数据：

• 所有通过pillar传输的信息能够保证被提交给目标主机，这使得Pillar引擎在Salt中被用来管理安全的信息，如，密码的Key和密码口令等。

从服务器配置：

• 从服务模块如远程执行模块，状态，反馈信息都可以使用存储在pillar中的数据来配置。

变量：

• 那些需要分配给特定的从服务器或者群组的变量可以在pillar中定义并且能够在SLS配置模板和稳重中使用。

任意数据：

• Pillar能够包含任意基本的数据结构，如，列表数据，或者k/v存储。可以让数据容易在SLS文档中使用。

因此，Pillar是在使用Slat的过程中最重要系统之一，这篇教程设计用来在几分钟之内编写一个简单的pillar文件，然后运用这个Pillar 使它的数据是可用的在pillar文件中。

设置Pillar

默认情况下，Pillar 已经运行在了Salt系统中，在从服务器上的Pillar的数据能够通过下面的命令查看到：

切换行号显示

   1 # salt '*' pillar.data     2 

默认情况下，主服务器的配置文件内容装载在pillar中，对所用的从服务器来说，通过配置主服务器的配置文件来使全局的从服务器生效。

Pillar是类似内置的state 文件，它有sls文件组成且有一个视图文件，就像state tree（翻译为,state 文件）。相对于state文件，Pillar 存储在Slat主服务器上的不同目录。默认的目录是/srv/pillar

Note

Pillar的目录能够通过修改主服务配置文件中的pillar_roots选项进行更改。

在配置Pillar之前，需要创建/srv/pillar目录。

切换行号显示

   1 # mkdir /srv/pillar     2 

一个简单的视图文件，格式类似state，需要创建，其内容如下：

/srv/pillar/top.sls

base:  '*':    - data

视图文件包含data.sls文件，这个文件在所有的从服务器上生效，/srv/pillar/data.sls文件如下：

/srv/pillar/data.sls

info: some data  

至此，保存该文件，从服务器上的pillars信息将被更新：

切换行号显示

   1 # salt '*' pillar.data    2 

info关键字的信息会出现在返回的pillar数据中

更多复杂的数据

Pillar文件是SLS文件，像states，但是不像sates文件，他们不需要定义格式，数据可以是任意的，下面的例子中，通过UID设置用户数据

/srv/pillar/usrs/init.sls

users:  thatch: 1000  shouse: 1001  utahdave: 1002  redbeard: 1003

Note

相同的目录中查找 states文件在Pilla目录中，因此 users/init.sls文件能够在视图文件中被引用。

视图文件需要更新一下以引用这个sls文件：

/srv/pillar/top.sls

base:  '*':    - data    - users

现在的话，这些数据对从服务器来说是可用的了。使用Jinjia 在state文件中引用pillar 中的数据。

/srv/salt/users/init.sls

{% for user, uid in pillar.get('users', {}).items() %}{{user}}:  user.present:    - uid: {{uid}}{% endfor %}

以上可以把users 安全的定义在一个pillar中，并且user 数据可以应用在sls文件中。

Pillar作为states 的参数

Pillar最重要的一个抽象功能就是能够作为states的参数。而不是定义宏或者函数，在states文件内容中，可以自由地参数化相对于所有的从服务器的pillar.

以上的话可以让Salt变的更加灵活，这意味着一些简单的sls格式的文件能够用作结构的参数而不需要重构state文件树。

一个简单的例子是根据不同的Linux 分发版本引导安装不同的软件包在pillar中定义。

/srv/pillar/pkg/init.sls

pkgs:  {% if grains['os_family'] == 'Debian' %}  apache: httpd  vim: vim-enhanced  {% elif grains['os_family'] == 'RedHat' %}  apache: apache2  vim: vim  {% elif grains['os'] == 'Arch' %}  apache: apache  vim: vim  {% endif %}

这个新的pkg sls需要增加到视图文件中：

/srv/pillar/top.sls

base:  '*':    - data    - users    - pkg

至此，从服务器将会根据各自的操作系统自动对应在pillar 只内定义的软件安装包，所以sls文件可以安全的引用：

/srv/salt/apache/init.sls

apache:  pkg.installed:    - name: {{ pillar['pkgs']['apache'] }}

更或者，假如pillar不可以用，也可以这样设置缺省值：

Note

在这个例子中使用的pillar.get 函数是在Salt 0.14.0版本中增加的。

/srv/salt/apache/init.sls

apache:  pkg.installed:    - name: {{ salt['pillar.get']('pkgs:apache', 'httpd') }}

在上面的例子中，假如 pillar 的变量pillar['pkgs'] ['apache'] 在从服务器上没有被设置，那么默认的'httpd'将会被使用。

Pillar使简单的states变的灵活

Pillar其中一个设计目标是使简单的sls格式变得易用和灵活，而不是需要复杂和重构state文件。简单的格式：

/srv/salt/edit/vim.sls

vim:  pkg:    - installed/etc/vimrc:  file.managed:    - source: salt://edit/vimrc    - mode: 644    - user: root    - group: root    - require:      - pkg: vim

可以很容易地转换成一个强大的、参数化公式:

/srv/salt/edit/vim.sls

vim:  pkg:    - installed    - name: {{ pillar['pkgs']['vim'] }}/etc/vimrc:  file.managed:    - source: {{ pillar['vimrc'] }}    - mode: 644    - user: root    - group: root    - require:      - pkg: vim

vimrc的源位置可以通过pillar 改变：

/srv/pillar/edit/vim.sls

{% if grain['id'].startswith('dev') %}vimrc: salt://edit/dev_vimrc{% elif grain['id'].startswith('qa') %}vimrc: salt://edit/qa_vimrc{% else %}vimrc: salt://edit/vimrc{% endif %}

确保正确的vimrc发送正确的从服务器上。

更多关于Pillar

Pillar的数据创建在Salt主服务器上并且安全的分发到从服务器上。Salt当定义pillar的时候 并不局限于pillar sls 文件，可以从其他额外的源取得数据。对于那些把基础结构信息存储在其他的地方会很有用。

参考信息和其他外部Pillar接口可以 在Salt 文档中找到：Pillar