Rump 项目技术文档

1. 安装指南

Rump 是一个帮助你在本地运行 Puppet 的工具，支持通过 Git 仓库进行快速迭代开发。以下是安装 Rump 的步骤：

安装 Rump

1. 确保你的系统已经安装了 Ruby 和 RubyGems。

2. 使用以下命令安装 Rump：

   $ gem install rump
   

安装完成后，你可以开始使用 Rump 来管理 Puppet 清单。

2. 项目的使用说明

基本使用流程

1. 克隆 Puppet 清单仓库：

   首先，使用 Rump 克隆你的 Puppet 清单仓库：

   $ rump clone [e-mail]:me_at_example_dot_org/puppet.git
   

2. 进入目录并运行 Puppet：

   进入克隆的目录，并使用 Rump 运行 Puppet：

   $ cd puppet
   $ sudo rump go
   

3. 迭代开发：

   在开发过程中，你可以通过以下步骤进行迭代：

   • 创建新分支：

     $ git checkout -b new_feature
     

   • 修改清单文件，并使用 --noop 选项预览更改：

     $ sudo rump go --noop
     

   • 应用更改：

     $ sudo rump go
     

   • 迭代直到功能稳定后，合并到主分支并推送：

     $ git checkout master
     $ git merge new_feature
     $ git push
     

冻结 Puppet

Rump 支持将 Puppet 和 Facter 冻结到你的清单仓库中，以便在不同版本的 Puppet 上进行测试。

1. 冻结 Puppet：

   使用以下命令冻结 Puppet 和 Facter：

   $ rump freeze
   

2. 管理 Puppet 版本：

   你可以通过编辑 Gemfile 来指定要冻结的 Puppet 版本：

   source :rubygems
   
   gem "puppet", "2.6.4"
   

   如果你想使用 Git 上的 Puppet 版本，可以这样配置：

   source :rubygems
   
   gem "puppet", "2.6.7", :git => "git://github.com/puppetlabs/puppet.git", :tag => "2.7.0rc1"
   gem "facter", "1.5.8", :git => "git://github.com/puppetlabs/facter.git", :tag => "1.5.9rc5"
   

3. 项目 API 使用文档

Rump 提供了简单的命令行接口，以下是主要命令的说明：

rump clone

克隆 Puppet 清单仓库：

$ rump clone [e-mail]:me_at_example_dot_org/puppet.git

rump go

运行 Puppet：

$ sudo rump go

你可以附加 Puppet 命令的选项，例如：

$ sudo rump go --verbose --debug --noop

rump freeze

冻结 Puppet 和 Facter：

$ rump freeze

4. 项目安装方式

Rump 的安装非常简单，只需使用 RubyGems 进行安装：

$ gem install rump

安装完成后，你可以通过命令行使用 Rump 来管理 Puppet 清单。

5. 开发与测试

开发环境设置

1. 克隆 Rump 仓库：

   $ git clone [e-mail]:your_repo/rump.git
   

2. 安装开发依赖：

   $ bundle install
   

运行测试

Rump 提供了 Cucumber 测试套件，你可以运行以下命令来执行测试：

$ cucumber features/

如果你不想运行需要网络连接的测试，可以使用以下命令：

$ cucumber --tags ~@online features/

6. 注意事项

1. Puppet 文件服务器：

   在 Puppet < 2.6 版本中，文件服务器的行为可能与预期不符，所有文件需要作为模板处理。

2. 清单模块化：

   清单需要放在模块中，以便 Puppet 正确识别。

7. 许可证

除非另有说明，所有内容版权 © 2014, Rails Machine, LLC