使用外部节点分类器
当 Puppet 运行在一个节点上,它需要知道这个节点应该应用了哪些类。 例如,如果这是一个 web 服务器节点,它可能需要包含一个 apache
类。 将类映射到节点的一种简单方法是在配置清单里声明,例如下面是一个 nodes.pp
文件的例子:
node web1 { include apache }
另外,你可以使用 外部节点分类器(external node classifier,ENC)来实现这个工作。 一个外部节点分类器是任何可执行程序,它可以接受一个节点的名称,并返回该节点的类列表。 例如,这可能是一个简单的 shell 脚本, 或者是对一个可以决定如何映射类到节点的更复杂的程序或 API 的封装。
准备工作
在你的 puppet.conf
配置文件中设置如下的参数:
[master] external_nodes = /usr/local/bin/puppet_node_classifier node_terminus = exec
操作步骤
创建如下的简单脚本
/usr/local/bin/puppet_node_classifier
:#!/bin/bash if [ "$1" == "cookbook.bitfieldconsulting.com" ]; then cat <<"END" --- classes: - admin::sudoers - admin::exim - puppet - nagios::target environment: production parameters: location: Bitfield HQ END else exit 1 fi
为该脚本添加可执行权限:
# chmod 755 /usr/local/bin/puppet_node_classifier
运行 Puppet:
# puppet agent --test info: Retrieving plugin info: Caching catalog for cookbook.bitfieldconsulting.com info: Applying configuration version '1299677816' notice: Finished catalog run in 1.19 seconds
工作原理
Puppet 调用你在 puppet.conf
中由参数 external_nodes
指定的脚本, 并传递节点的名称作为命令行参数。在本例的脚本中,我们检查这个参数, 如果它与 cookbook.bitfieldconsulting.com
相同,将为其输出一个 Puppet 所需的 YAML 格式的类列表。 否则,此脚本将返回退出状态码 1(向 Puppet 指出该节点没有被发现)。
该脚本还设置了 environment
的值(参见 使用不同的环境 一节中关于这个参数的解释)。 同时将变量 location
设置成了 Bitfield HQ
— 此变量是个自定义变量,对于 Puppet 并无特殊含义, 但是由于在 ENC 中定义的变量是顶级范围的变量,可以在你的配置清单里引用此处定义的变量, 所以,例如你可以使用它决定 DNS 解析器的设置。你可以在此设置任何你需要的变量。
显然,这个脚本并不十分有用,因为它只是输出了一个预先确定的类列表。 一个更复杂的脚本可能会检查数据库,从中查找节点所需的类列表, 或从一个哈希或外部文本文件中查找节点所需的类列表。 我希望,这个例子足以让你开始写出自己的更复杂的外部节点分类器。
有关外部节点分类器的详细信息,请参考: http://docs.puppetlabs.com/guides/external_nodes.html 。
更多用法
使用外部分类器的主要用途是使 Puppet 可以连接 LDAP 目录服务。 许多大型组织都有个 LDAP 基础设施,你可以设置 Puppet,使它可以从 LDAP 目录服务获取信息, 并且其他 LDAP 客户也可以通过 Puppet 获得由其管理的节点信息。
欲了解更多有关如何做到这一点的详细信息,请访问 “Puppet 和 LDAP” 页面: http://projects.puppetlabs.com/projects/puppet/wiki/LDAP_Nodes 。
此功能也可用于 Puppet Dashboard 和 Foreman 通过 Web 界面管理节点和类之间的关系 — 他们将以外部节点分类器来处理。