Travis Sous Chef 技术文档

1. 安装指南

Travis Sous Chef 是一个用于开发和使用 Chef cookbooks 的项目，特别适用于 Travis CI 环境，但不仅限于 Travis CI。在开始使用之前，请确保您的系统中安装了以下依赖项：

虚拟机软件

• 安装 VirtualBox 4.1.x：
  • 对于 Mac OS X
  • 对于 64-bit Linux distributions

Vagrant

• 安装 Vagrant

Cookbooks 目录

• 复制示例 Vagrant 文件：

  cp Vagrantfile.sample Vagrantfile
  

• 创建一个 cookbooks 目录或克隆一个现有的 cookbooks 集合，如 Travis CI cookbooks：

  mkdir cookbooks
  # 或者
  git clone git://github.com/travis-ci/travis-cookbooks.git cookbooks
  

• 在 Vagrantfile 中允许使用 Chef 进行配置，需要取消注释以下行（包括其关联的结束语句）：

  config.vm.provision :chef_solo do |chef|
  

• 指定 Vagrant 的 cookbooks 路径，对于 Travis CI cookbooks，只需取消注释以下行：

  chef.cookbooks_path = ["cookbooks/ci_environment"]
  

  对于其他 cookbooks 集合，提供一个本地路径（或多个）：

  chef.cookbooks_path = ["cookbooks"]
  

  如果需要，可以使用多个 cookbooks 位置。

• 选择一些 cookbooks 进行配置，例如，对于 Travis CI cookbooks，可以取消注释以下行：

  chef.add_recipe "build-essential"
  

• 配置 Vagrantfile：

  Vagrant::Config.run do |config|
    config.vm.box = "precise64_base"
    config.vm.box_url = "http://files.vagrantup.com/precise64.box"
  
    config.vm.provision :chef_solo do |chef|
      chef.cookbooks_path = ["cookbooks/ci_environment"]
  
      chef.add_recipe "build-essential"
    end
  end
  

创建虚拟机

• 创建一个 Ubuntu 虚拟机：

  vagrant up
  

2. 项目的使用说明

配置虚拟机

• 使用以下命令配置虚拟机：

  vagrant provision
  

  根据所选的 recipes，配置过程可能需要几秒到几分钟不等。

检查环境

• 配置完成后，使用以下命令 SSH 进入虚拟机检查环境：

  vagrant ssh
  

完成工作

• 工作完成后，可以选择关闭虚拟机以供以后使用：

  vagrant halt
  

• 或者完全销毁虚拟机：

  vagrant destroy
  

3. 项目 API 使用文档

Travis Sous Chef 的 API 使用文档尚待补充。

4. 项目安装方式

Travis Sous Chef 的安装方式已在“安装指南”一节中详细说明。请参考上文步骤进行安装。