### 使用公共模块
> Plagiarize, plagiarize, plagiarize / Only be sure always to call it, please _research_.
>
> _Lobachevsky_
> — Tom Lehrer
如果你对自己编制的代码有疑问,使用他人的吧。在许多情况下, 当你要写一个 Puppet 模块来管理一些软件或服务时,不必从头开始编写。 对许多流行的应用程序,在 **Puppet Forge** 站点上都提供了社区贡献的模块。 有时,一个社区模块正是你所需要的,你可以下载并马上开始使用它。 若社区提供的模块不能满足你的需求,你可以对其进行一些修改,以适应你的特定需求和环境。
如果你是个 Puppet 的新手,能从一些现有的代码开始对你将是一个很大的帮助。但另一方面, 社区模块往往编写得尽可能通用和便携,为了实现此目的所需的额外代码可能使其更难理解。
一般地,在你未阅读和理解 Puppet Forge 提供的模块代码之前, 我建议你不要将其作为 ‘活动的(drop-in)’ 模块源来部署。 Puppet Forge 提供的模块为你的 Puppet 基础设施引入了一个外部的依赖, 但它并不能帮你提升对 Puppet 的理解也不利于提升你使用 Puppet 的经验。 相反,我会用它作为一个获取灵感的源泉,从这方面讲它还是很有帮助的。 从 Puppet Forge 获取的模块应该是一个起点,你可以用它作为基础,制定和完善自己的模块。
要知道,一个给定的模块可能无法在你的 Linux 发行上工作。请检查模块自带的 README 文件,查看这个模块是否支持你的操作系统。
#### 准备工作
1. 使用 Puppet Forge 模块的最简单方法是安装 puppet-module 工具:
```
# gem install puppet-module
Fetching: puppet-module-0.3.2.gem (100%)
******************************************************************
Thank you for installing puppet-module from Puppet Labs!
* Usage instructions: read "README.markdown" or run `puppetmodule
usage`
* Changelog: read "CHANGES.markdown" or run `puppet-module
changelog`
* Puppet Forge: visit http://forge.puppetlabs.com/
******************************************************************
Successfully installed puppet-module-0.3.2
1 gem installed
Installing ri documentation for puppet-module-0.3.2...
Installing RDoc documentation for puppet-module-0.3.2...
```
2. 运行 puppet-module 查看其可用的任务:
```
# puppet-module
Tasks:
puppet-module build [PATH_TO_MODULE]
# Build amodule for release
puppet-module changelog
# Display the changelog for this tool
puppet-module changes [PATH_TO_MODULE]
# Show modified files in an installed m...
puppet-module clean
# Clears module cache for all repositories
puppet-module generate USERNAME-MODNAME
# Generate boilerplate for a new module
puppet-module help [TASK]
# Describe available tasks or one speci...
puppet-module install MODULE_NAME_OR_FILE [OPTIONS]
# Install a module (eg, 'user-modname')...
puppet-module repository
# Show currently configured repository
puppet-module search TERM
# Search the module repository for a mo...
puppet-module usage
# Display detailed usage documentation ...
puppet-module version
# Show the version information for this...
Options:
-c, [--config=CONFIG] # Configuration file
# Default: /etc/puppet/puppet.conf
```
#### 操作步骤
在本例中,我们将使用 puppet-module 查找并安装一个管理 Tomcat 应用程序服务器的模块。
1. 查找合适的模块:
```
# puppet-module search tomcat
=====================================
Searching http://forge.puppetlabs.com
-------------------------------------
2 found.
--------
camptocamp/tomcat (0.0.1)
jeffmccune/tomcat (1.0.1)
```
2. 在本例中,我们将安装 Jeff McCune 版本的 tomcat 模块:
```
# cd /etc/puppet/modules
# puppet-module install jeffmccune/tomcat
Installed "jeffmccune-tomcat-1.0.1" into directory:
jeffmccune-tomcat
```
3. 现在就可以在你的配置清单中使用这个模块了:查看其源代码将向你展示这是如何实现的。
#### 工作原理
puppet-module 工具使用简单地自动化过程从 Puppet Forge 站点搜索和下载模块。 你也可以浏览该网站查询可用的模块: [http://forge.puppetlabs.com/](http://forge.puppetlabs.com/) 。
#### 更多用法
并非所有公开可用的模块都保存在 Puppet Forge 上。其他的存放位置是在 GitHub 上:
* [https://github.com/camptocamp](https://github.com/camptocamp)
* [https://github.com/example42](https://github.com/example42)
Dean Wilson 在他的 Puppet Cookbook 站点: [http://puppetcookbook.com/](http://puppetcookbook.com/) 维护了一个优秀的 Puppet 的仓库,还包括一些技巧和处方。
- 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
- 使用公共模块
- 使用外部节点分类器
- 创建自定义的资源类型
- 创建自定义的提供者