### 使用 define 资源
> Girl number twenty unable to define a horse!" said Mr. Gradgrind.?—?Charles Dickens.
>
> — Hard Times
除非你知道如何定义你想要什么,不然不会得到预期的结果。 在上一节的示例中,我们看到了如何将同类资源组合成数组从而减少冗余代码。 然而,这种技术有一个限制,那就是所有的资源必须使用相同的参数。 当你有一组资源拥有一些公用的参数而其中一些资源确有不同的参数时, 就需要使用 define 资源将它们组合在一起。
#### 操作步骤
1. 在配置清单中添加如下代码:
```
define tmpfile() {
file { "/tmp/$name":
content => "Hello, world",
}
}
tmpfile { ["a", "b", "c"]: }
```
2. 运行 Puppet:
```
notice: /Stage[main]//Node[cookbook]/Tmpfile[a]/File[/tmp/a]/
ensure: defined content as '{md5}bc6e6f16b8a077ef5fbc8d59d0b931b9'
notice: /Stage[main]//Node[cookbook]/Tmpfile[b]/File[/tmp/b]/
ensure: defined content as '{md5}bc6e6f16b8a077ef5fbc8d59d0b931b9'
notice: /Stage[main]//Node[cookbook]/Tmpfile[c]/File[/tmp/c]/
ensure: defined content as '{md5}bc6e6f16b8a077ef5fbc8d59d0b931b9'
```
#### 工作原理
你可以认为 **define** 就像是一个饼干切割器。它描述了一种模式,Puppet 可以用它创建许多类似的资源。任何时候你都可以在你的配置清单中声明 tmpfile 实例,Puppet 将会插入包含在 tmpfile 定义中的所有资源。
在我们的例子中,名为 tmpfile 的 define 包含了一个 file 资源, 其 content 为 "Hello, world";其 path 为 "/tmp/$name"。 如果你用名字 foo 声明了一个 tmpfile 实例,如下所示:
```
tmpfile { "foo": }
```
会被 Puppet 要创建的实例名字所代替。这就像是我们创建了一个新的资源类型: tmpfile,它包含一个参数(即其名字)。
与常规资源一样,我们不仅可以为其传递一个字符串的名字,我们还可以传递一个数组名, Puppet 会对每一个数组元素创建一个 tmpfile 实例,就像上面的例子那样。
#### 更多用法
在上面的例子中,我们定义的 define 仅有一个名字参数,不同实例的名字不同。 但是我们可以为其添加任何我们想要的参数,只要我们在 define 中声明这些参数即可:
```
define tmpfile( $greeting ) {
file { "/tmp/$name":
content => $greeting,
}
}
```
当我们声明一个资源的实例时,可以为其传递参数值,例如:
```
tmpfile{ "foo": greeting => "Hello, world" }
```
你可以使用逗号间隔的列表同时声明多个参数:
```
define webapp( $domain, $path, $platform ) {
...
}
webapp { "mywizzoapp":
domain => "mywizzoapp.com",
path => "/var/www/apps/mywizzoapp",
platform => "Rails",
}
```
这是对某些常见的资源进行抽象的一项强大的技术,抽象出资源之间的共性并保存在一个地方, 你就**不必每次都做重复劳动**(**Don’t Repeat Yourself**)。 在上面的例子中,webapp 里或许有许多独立的资源:软件包(packages)、配置文件(config files)、 源码检出(source code checkouts)、虚拟主机(virtual hosts)等等, 但是除了我们为 webapp 提供的参数不同之外,所有实例要执行的工作都相同。 这些可能会在模板中引用,例如:为一个虚拟主机设置域名。
- 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
- 使用公共模块
- 使用外部节点分类器
- 创建自定义的资源类型
- 创建自定义的提供者