### 测试你的 Puppet 配置清单
> If all else fails, immortality can always be assured by spectacular error.
>
> — J.K. Galbraith
你总会遭遇麻烦,就像趴在你的挡风玻璃上的一只虫子。遗憾的是像 **Nagios** 那样标准的检测监视工具也不能面面俱到地检测你要的一切。 许多技术指标对于排错是很有帮助的,例如平均负载和磁盘占用, 我更希望我的系统能提供关于应用和服务的更高级别的信息。
例如,如果你运行的是一个 web 应用程序,你不能肯定它正监听 80 端口并能返回 HTTP 200 OK 状态。也许它只是返回 Apache 默认的欢迎页面。
如果你的 web 应用程序是一个在线商店,例如:你可能希望检查以下几项:
* 大家能否看到预期的页面(例如:“欢迎光临 FooStore”)?
* 用户能否正常登录(假定应用程序支持 session 会话)?
* 搜索某种产品能否返回期待的结果?
* 响应时间是否令人满意?
这种监控(专注于应用程序的行为,而不是对服务器自身指标的度量) 经常被称作 **行为驱动的监控**(**behavior-driven monitoring**)。
与开发者改变代码后经常使用行为驱动的测试(behavior-driven tests) 来校验应用程序是否正常一样, 你可以在产品上线后持续地使用行为驱动的监控。
事实上,感谢有 cucumber-nagios 这样的工具存在,你可以和开发人员使用同样的测试。 Lindsay Holmwood 为流行的 **Cucumber** 测试框架所做的封装可以让你运行针对 Nagios 的基于 Cucumber 的测试,这似乎是对 Nagios 进行评估的标准方法。
#### 准备工作
1. 为了安装 cucumber-nagios ,你首先要安装依赖的包。如果你在用 Ubuntu 或 Debian, 可能需要从源代码安装 **RubyGems** ,因为 cucumber-nagios 需要 RubyGems 1.3.6 或更高的版本。 从 RubyGems 站点: [http://rubygems.org/pages/download](http://rubygems.org/pages/download) 下载 **tarball** 。 解压缩之后运行 ruby setup.rb 编译并安装此软件包。
2. 接下来,你需要安装相关依赖包:
```
# apt-get install ruby1.8-dev libxml2-dev
```
3. 最后,使用如下命令安装 cucumber-nagios :
```
# gem install cucumber-nagios
```
#### 操作步骤
1. 一旦 RubyGems 和相关依赖安装完成后,你就可以开始写 Cucumber 测试了。 要做到这一点,首先使用 cucumer-nagios-gen 来帮助我们创建一个项目目录和所需要的一切:
```
# cucumber-nagios-gen project mytest
Generating with project generator:
[ADDED] features/steps
[ADDED] features/support
[ADDED] .gitignore
[ADDED] .bzrignore
[ADDED] lib/generators/feature/%feature_name%.feature
[ADDED] Gemfile
[ADDED] bin/cucumber-nagios
[ADDED] lib/generators/feature/%feature_name%_steps.rb
[ADDED] README
```
你新创建的 cucumber-nagios 项目可以在 /root/mytest 找到。
下一步, 使用如下命令安装所需的 RubyGems:
```
bundle install
```
你的项目已经作为一个 git 仓库初始化了。
2. 有一个好主意是在项目目录里运行 bundle install ,因为 cucumber-nagios 建议你这么做。这样做的话 cucumber-nagios 会在项目目录里安装所有依赖的包。 然后你就可以移动项目目录到其他任何一台机器,不必再安装依赖包就可以工作。
```
# cd mytest
# bundle install
```
3. 现在我们开始写测试。下面的例子用于测试 Google 的主页:
```
# cucumber-nagios-gen feature www.google.com home
Generating with feature generator:
[ADDED] features/www.google.com/home.feature
[ADDED] features/www.google.com/steps/home_steps.rb
```
4. 如果你要编辑 home.feature 文件, 会发现 cucumber-nagios 已经为你生成了一个基本的测试:
```
Feature: www.google.com
It should be up
Scenario: Visiting home page
When I go to "http://www.google.com"
Then the request should succeed
```
你可以在项目下使用如下命令运行这个测试:
```
# cucumber --require features features/www.google.com/home.feature
Feature: www.google.com
It should be up
Scenario: Visiting home page # features/www.google.
com/home.feature:4
When I go to "http://www.google.com" # features/steps/http_
steps.rb:11
Then the request should succeed # features/steps/http_
steps.rb:64
1 scenario (1 passed)
2 steps (2 passed)
0m0.176s
```
5. 假设一切正常(若不正常,请联系 Google), 要对 Nagios 的检测使用此特性, 你要做的所有工作就是使用 cucumber-nagios 代替 cucumber :
```
# bin/cucumber-nagios features/www.google.com/home.feature
CUCUMBER OK - Critical: 0, Warning: 0, 2 okay | passed=2;
failed=0; nosteps=0; total=2; time=0
```
#### 工作原理
任何脚本都可以成为 Nagios 监控的一个插件; 它只是返回执行完成后退出的状态 (0 为成功,1 为警告,2 为紧急)。cucumber-nagios 封装 Cucumber 来实现测试, 并且打印出有用信息,而后 Nagios 将通过警告或者 web 接口发送报告。
#### 更多用法
就其本身而言,并非你在此做的所有工作都有用。但不管怎样,Cucumber 可以让你写出十分复杂的 Web 交互脚本: 你可以填写表单字段、搜索、 单击按扭、在页面上匹配文本等等。要监控你的 web 应用或服务的任何特性, 首先弄清楚用户使用 web 浏览器的行为习惯,然后根据这些用户行为, 使用 Cucumber 创建自动监控脚本。
你可以从 Cucumber 网站 [http://cukes.info/](http://cukes.info/) 上找到更多关于 cucumber-nagios 的信息。
- 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
- 使用公共模块
- 使用外部节点分类器
- 创建自定义的资源类型
- 创建自定义的提供者