### 使用纯 Ruby 代码书写配置清单
你会说西班牙语吗?学习一门语言可能会很有趣,但并非所有人都想这么做。 Puppet 有时会因为它使用自己专用的配置语言而不是现存的通用语言(如 Ruby)书写配置清单而遭到批评。
不是每个人都认为这是个缺点。计算机科学家 Dennis Ritchie 说:
> A language that doesn’t have everything is actually easier to program in than some that do.
>
> — Dennis Ritchie
无论你是什么观点,这种批评已不再适用。因为 Puppet 已经拥有了使用 Ruby 语言书写配置清单的实验性支持,这在生产环境上是相当有用的,即使还处于早期开发阶段。 在你的配置清单中可以混合使用两种语言,Puppet 以文件扩展名进行区别,扩展名 .rb 表示用 Ruby 语言书写的配置清单文件,而扩展名 .pp 表示 Puppet 专用的配置语言文件。
为了书写配置清单使用的 Ruby 的 **特定领域语言**(**domain-specific language,DSL**) 看上去与标准的 Puppet 语言非常相似。 在下面的例子中,我将向你展示如何将典型的 Puppet 配置清单转换成 Ruby 的。 Puppet 语法的原始配置清单如下:
```
class admin::exim {
package { "exim4": ensure => installed }
service { "exim4":
ensure => running,
require => Package["exim4"],
}
file { "/etc/exim4/exim4.conf":
content => template("admin/exim4.conf"),
notify => Service["exim4"],
require => Package["exim4"],
}
}
```
#### 操作步骤
1. 使用如下内容创建 /etc/puppet/modules/admin/manifests/exim.rb 文件:
```
hostclass "admin::exim" do
package "exim4", :ensure => :installed
service "exim4",
:ensure => :running,
:require => "Package[exim4]"
file "/etc/exim4/exim4.conf",
:content => template(["admin/exim4.conf"]),
:notify => "Service[exim4]",
:require => "Package[exim4]"
end
```
2. 在一个节点中包含这个类并运行 Puppet。
#### 工作原理
1. 关键字 hostclass 声明一个类,就像 Puppet 中的 class:hostclass admin::exim do
2. 然后跟一个 do … end 语句块,这相当于 Puppet 的一对大括号。
3. 通过在资源类型后调用函数来声明资源: 例如 package 或 service:package "exim4", :ensure => :installed
4. 传递给函数的参数是一个用逗号分割的列表,参数必须要用双引号括起来, 或者在参数前使用前导的冒号使其成为 Ruby symbol 对象: :ensure => :running,
又如,像 :installed 或 :running 这样的 Puppet 内置名字都是 Ruby 的 symbol 对象。
| ![注记](https://box.kancloud.cn/2016-05-12_5733eec619643.png) | 译者注
有关 Ruby Symbol 的详细介绍请参考: [http://www.ibm.com/developerworks/cn/opensource/os-cn-rubysbl/](http://www.ibm.com/developerworks/cn/opensource/os-cn-rubysbl/)
|
5. 当我们需要引用资源来表示相互关系时,就要使用 :require, 资源标识符通过首字母大写的资源类型跟上写在一对方括号中的资源名给出,例如: require => "Package[exim4]"
在调用像模板这样的函数时可以使用函数名跟一对圆括号,在圆括号中传递的参数是 一对用方括号声明的数组,例如::content => template(["admin/exim4.conf"]),。
#### 更多用法
Ruby DSL 尚处于早期开发阶段。试验虽然有趣,除非你有使用 Ruby 的令人信服的理由否则先别用它, 至今我仍旧使用标准的 Puppet 语言。或许将来 Ruby DSL 会被广泛应用,但在此期间, 你会发现没有它的生活会更轻松。然而,若你坚持要使用它,下面介绍几个非常有用的提示。
##### 变量
当你像常规的 Ruby 程序一样使用 Ruby 变量时,可以使用 scope.lookupvar 访问你的 Puppet 变量,例如:
```
notice( "I am running on node %s" % scope.lookupvar("fqdn") )
```
将得到:
```
notice: I am running on node cookbook.bitfieldconsulting.com
```
要在你的 Puppet 配置清单范围内设置变量,使用 scope.setvar,例如:
```
require 'time'
scope.setvar("now", Time.now)
notice( "At the third stroke, the time sponsored by Bitfield
Consulting will be: %s" % scope.lookupvar("now") )
```
上面的代码将获得如下结果:
```
notice: At the third stroke, the time sponsored by Bitfield Consulting
will be: Wed Mar 23 05:58:16 -0600 2011
```
##### 文档
你可以在 Puppet Labs 网站找到更多如何使用 Ruby DSL 的详细资料,包括诸如 **virtual resources** 和 **collections** 这样的高级主题: [http://projects.puppetlabs.com/projects/1/wiki/Ruby_Dsl](http://projects.puppetlabs.com/projects/1/wiki/Ruby_Dsl) 。
Ken Barber 提供了一些语法例子,并对 Puppet 语法和 Ruby DSL 结构做了比较,网址在 [https://github.com/bobsh/puppet-rubydsl-examples](https://github.com/bobsh/puppet-rubydsl-examples) 。
最后,James Turnbull 发布过一篇 blog, 展示了使用 Ruby 连接 MySQL 服务器的高级方法: [http://www.puppetlabs.com/blog/using-ruby-inthe-puppet-ruby-dsl/](http://www.puppetlabs.com/blog/using-ruby-inthe-puppet-ruby-dsl/) 。
- Puppet 2.7 Cookbook 中文版
- 中文翻译版
- 译者序
- 项目缘起
- 翻译方法
- 社区链接
- 社区建议
- 贡献者
- 原书版权页
- 关于作者
- 前言
- 本书内容
- 阅读前提
- 适用读者
- 格式约定
- 读者反馈
- 客户支持
- 下载案例代码
- 勘误表
- Puppet 基础设施
- 使用版本控制
- 使用提交钩子
- 使用 Rake 部署变更
- 配置 Puppet 的文件服务器
- 从 cron 运行 Puppet
- 使用自动签名
- 预签名证书
- 从 Puppet 的 filebucket 检索文件
- 使用 Passenger 扩展 Puppet 的部署规模
- 创建去中心化的分布式 Puppet 架构
- 监控、报告和排错
- 生成报告
- 通过 Email 发送包含特定标签的日志信息
- 创建图形化报告
- 自动生成 HTML 文档
- 绘制依赖关系图
- 测试你的 Puppet 配置清单
- 执行模拟运行
- 检测编译错误
- 理解 Puppet 的错误信息
- 显示命令的输出结果
- 输出调试信息
- 检查配置设置
- 使用标签
- 使用运行阶段
- 使用不同的环境
- Puppet 语言及其写作风格
- 使用 Puppet 社区规范
- 使用模块
- 使用标准的命名规范
- 使用嵌入式 Ruby 代码
- 使用纯 Ruby 代码书写配置清单
- 遍历多个项目
- 书写强大的条件语句
- 在 if 语句中使用正则表达式
- 使用选择器和 case 语句
- 检测字符串中是否包含指定的值
- 使用正则表达式替换
- 书写更优质的配置清单
- 使用资源的数组
- 使用 define 资源
- 指定资源的依赖关系
- 使用节点继承
- 使用类的继承和重载
- 给类传递参数
- 书写可重用的跨平台配置清单
- 获得系统的环境信息
- 导入动态信息
- 从 CSV 文件导入数据
- 给 Shell 命令传递参数
- 使用文件和软件包
- 为配置文件添加配置行
- 使用 Augeas 自动修改配置文件
- 使用配置片段构建配置文件
- 使用 ERB 模板
- 在模板中遍历数组
- 从第三方仓库安装软件包
- 配置 APT 软件仓库
- 配置 GEM 仓库
- 从源码包自动构建软件
- 比较软件包的版本
- 用户和虚拟资源
- 使用虚拟资源
- 使用虚拟资源管理用户
- 管理用户基于密钥的 SSH 访问
- 管理用户的自定义文件
- 有效地分发 cron 任务
- 当文件更新时运行命令
- 使用主机资源
- 为文件资源指定多个源
- 使用文件资源递归地分发整个目录树
- 清理过期的旧文件
- 使用日程表资源
- 资源的审计
- 临时禁用资源
- 管理时区
- 应用程序
- 管理 Apache 服务
- 创建 Apache 虚拟主机
- 创建 Nginx 虚拟主机
- 创建 MySQL 数据库及用户
- 管理 Drupal 站点
- 管理 Rails 应用程序
- 服务器和云基础设施
- 部署 Nagios 监控服务器
- 使用 Heartbeat 构建高可用服务
- 管理 NFS 服务和文件共享
- 使用 HAProxy 为多个 web 服务器实现负载均衡
- 使用 iptables 管理防火墙
- 管理 Amazon 的 EC2 实例
- 使用 Vagrant 管理虚拟机
- 外部工具和 Puppet 生态环境
- 创建 Facter 的自定义 fact
- 在运行 Puppet 之前和之后执行命令
- 从 Shell 会话生成 Puppet 配置清单
- 从运行的系统上生成 Puppet 配置清单
- 使用 Puppet Dashboard
- 使用 Foreman
- 使用 MCollective
- 使用公共模块
- 使用外部节点分类器
- 创建自定义的资源类型
- 创建自定义的提供者