持续集成- Rails自动构建与Capistrano

我曾经是一个。net爱好者，喜欢使用一个叫做CruiseControl的夜间构建系统(持续集成)。. NET将我的应用程序每晚自动部署到我的登台环境。

现在我已经跳到Ruby on Rails和GitHub，我发现自己有点困惑，如何设置一个等效的自动化，夜间构建系统。我想做正确的事情，Rails的方式，但我可以在正确的方向上使用推动。

Ruby on Rails 3.2.9(带资产管道)
RVM
Apache + Passenger
GitHub (SCM)

我正在寻找一个满足这些要求的系统/解决方案:(理想情况下使用Capistrano…)

从我的GitHub存储库中的"master"分支部署最新的提交到我的登台服务器。
按需一键构建:我想在任何时候单击按钮或链接来强制部署(或重新部署)
能够在暂存服务器上运行自定义命令，作为部署的一部分(例如:'bundle install'，重启Apache等)
在GitHub上每日或提交后自动部署(可选)

因为我从来没有问过这个问题没有做过一些研究，这里是我找到的一些相关资源，但还没有能够破译:

通过Git自动部署
使用Capistrano部署Rails 3应用

建议,有人知道吗?谢谢!

关于如何将Capistrano用于此目的(包括Prakash的参考)，事实证明有很多很好的信息，但似乎没有一个是完全全面的。

经过几个小时的浏览指南，浏览论坛，浏览堆栈溢出问题，我设法实现了我的大部分目标。为了节省别人的时间，我将尽量提供我在原始问题的上下文中找到的答案和信息。

原来我一直在寻找Jenkins:它是一个完美的(甚至是一个改进的)模拟CruiseControl构建服务器应用程序我以前使用过。Jenkins是一个web应用程序，可以在计划的基础上启动构建，或者通过插件提交事件。它不包括实际部署我的Rails应用程序的功能，所以这就是Capistrano的作用。使用Jenkins的"shell execute"构建任务来触发Capistrano部署，我能够完成上述所有目标。

请参阅本指南了解更多细节。

原始文章:

首先，Capistrano可以用于构建系统，但是，它与CruiseControl完全不同。

CruiseControl是:

一个web应用程序，运行在一台作为"构建服务器"的机器上
任何用户都可以访问web应用程序运行构建;用户不需要在他们的终端上设置或配置任何东西。这只是一个网页。
该接口还提供了日志、责备、计划构建等功能。

Capistrano是:

不是一个应用程序或服务，而是一个像rake一样工作的gem;它具有与CruiseControl用于部署的Ant和Nant脚本类似的功能。
Capistrano运行在用户的本地机器上(通常是Rails应用程序文件夹)，并且需要在他们的端进行配置才能运行
它直接从用户的机器通过SSH连接到远程服务器来执行部署(如果您不想授予用户SSH访问远程服务器的权限，这可能不太可取)
命令通过控制台运行，即cap deploy(这是接近'一键'部署。)
生成日志，执行回滚等。
它不会自己启动预定的构建(建议使用cron)

关于我最初的要求…

从我的GitHub存储库中的master分支部署最新的提交到我的登台服务器。

配置Capistrano的部署。

按需一键构建:我想在任何时候单击按钮或链接来强制部署(或重新部署)

所有Capistrano部署都是通过'force'完成的:你可以手动在控制台中运行'cap deploy'

能够在暂存服务器上运行自定义命令，作为部署的一部分(例如:'bundle install'，重启Apache等)

配置Capistrano的部署。Rb文件将完成此操作。这些命令中的大多数都是现成的。

在GitHub上每日或提交后自动部署(可选)

我还没弄明白这个…cron作业可能是最好的方法。

设置Capistrano

先从GitHub开始学习这个教程。在你的Rails App文件夹中，你应该以Capfile和config/deploy.rb文件结束。

为了节省您的时间，复制并粘贴这些文件，并根据您的需要调整设置。下面的文件配置为:

部署到测试环境
GitHub
基于RVM的Rails
包括未跟踪的文件(即没有提交到SCM的database.yml文件)
使用Rails资源管道
在每次部署时运行迁移和种子
在每次部署时重新启动基于Apache的Passenger

Capfile

# Set this if you use a particular version of Ruby or Gemset
set :rvm_ruby_string, 'ruby-1.9.3-p286@global'
#set :rvm_ruby_string, ENV['GEM_HOME'].gsub(/.*//,"") # Read from local system
require "bundler/capistrano"
# Uncomment this if you're using RVM
require "rvm/capistrano"
load 'deploy'
# Uncomment if you are using Rails' asset pipeline
load 'deploy/assets'
load 'config/deploy' # remove this line to skip loading any of the default tasks

配置/deploy.rb

# BEGIN RUBY CONFIG
# You can manually override path variables here
# set :default_environment, {
#     'PATH' => "/usr/local/bin:/bin:/usr/bin:/bin:/<ruby-dir>/bin",
#     'GEM_HOME' => '<ruby-dir>/lib/ruby/gems/1.8',
#     'GEM_PATH' => '<ruby-dir>lib/ruby/gems/1.8',
#     'BUNDLE_PATH' => '<ruby-dir>/lib/ruby/gems/1.8/gems'  
# }
# This changes the default RVM bin path
# set :rvm_bin_path, "~/bin"
# If your remote server doesn't have a ~/.rvm directory, but is installed
# at the /usr/local/rvm path instead, use this line
set :rvm_type, :system
# END RUBY CONFIG
default_run_options[:pty] = true  # Must be set for the password prompt
                                  # from git to work
# BEGIN MULTIPLE ENVIRONMENT DEPLOYS
# Read the following URL if you need to deploy to different environments (test, development, etc)
# https://github.com/capistrano/capistrano/wiki/2.x-Multistage-Extension
# set :stages, %w(production test)
# set :default_stage, "test"
# require 'capistrano/ext/multistage'
# END MULTIPLE ENVIRONMENT DEPLOYS
# BEGIN APPLICATION VARS
set :application, "yourapp"
set :rails_env, 'test'
# END APPLICATION VARS
# BEGIN PATH DEFINITIONS
set(:releases_path)     { File.join(deploy_to, version_dir) }
set(:shared_path)       { File.join(deploy_to, shared_dir) }
set(:current_path)      { File.join(deploy_to, current_dir) }
set(:release_path)      { File.join(releases_path, release_name) }
# END PATH DEFINITIONS
# BEGIN SCM VARS
set :repository, "git@github.com:yourgithubuser/yourrepository.git"  # Your clone URL
set :scm, "git"
set :scm_username, "yourgithubuser"
set :scm_password, proc{Capistrano::CLI.password_prompt('GitHub password:')}  # The deploy user's password
set :branch, "master"
# END SCM VARS

# BEGIN SERVER VARS
set :user, "ubuntu"  # The server's user for deploys
role :web, "dev.#{application}" # The location of your web server i.e. dev.myapp.com
role :app, "dev.#{application}" # The location of your app server i.e. dev.myapp.com
role :db, "dev.#{application}", :primary => true  # The location of your DB server i.e. dev.myapp.com
set :deploy_to, "/home/#{user}/www/#{application}"
set :deploy_via, :remote_cache
# Uncomment this if you want to store your Git SSH keys locally and forward
# Else, it uses keys in the remote server's .ssh directory
# ssh_options[:forward_agent] = true
# END SERVER VARS
# BEGIN ADDITIONAL TASKS
before "deploy:start" do
  deploy.migrate
  deploy.seed
end
before "deploy:restart" do
  deploy.migrate
  deploy.seed
end
# Some files that the Rails app needs are too sensitive to store in SCM
# Instead, manually upload these files to your <Rails app>/shared folder
# then the following code can be used to generate symbolic links to them,
# so that your rails app may use them.
# In this example below, I link 'shared/config/database.yml' and 'shared/db/seed_data/moderators.csv'
before "deploy:assets:precompile" do
  run ["ln -nfs #{shared_path}/config/settings.yml #{release_path}/config/settings.yml",
       "ln -nfs #{shared_path}/config/database.yml #{release_path}/config/database.yml",
       "mkdir -p #{release_path}/db/seed_data",
       "ln -nfs #{shared_path}/db/seed_data/moderators.csv #{release_path}/db/seed_data/moderators.csv",
       "ln -fs #{shared_path}/uploads #{release_path}/uploads"
  ].join(" && ")
end
namespace :deploy do
  # Define seed task (call 'cap deploy:seed')
  desc "Reload the database with seed data"
  task :seed do
    run "cd #{current_path}; bundle exec rake db:seed RAILS_ENV=#{rails_env}"
  end
  # If you are using Passenger mod_rails uncomment this:
  task :start do ; end
  task :stop do ; end
  task :restart, :roles => :app, :except => { :no_release => true } do
    run "#{try_sudo} touch #{File.join(current_path,'tmp','restart.txt')}"
  end
end
# END ADDITIONAL TASKS

是。Capistrano是您正在寻找的工具。使用Capistrano和系统cron应该使您能够实现具有上述所有四种需求的构建/部署系统。这很容易。

了解Capistrano的最佳资源是《部署Rails》一书。它有两章介绍Capistrano，第一章介绍基本用法，第二章介绍一些高级用法概念。最后还有一个Capistrano案例研究，通过一个真实的部署脚本示例探索了更多的配置选项。

仅供参考:我昨天在几个小时内读完了这两章，并发了推文;-)

我建议使用Capistrano作为部署部分。

CI部分(当你做git push时构建)最好通过使用CI服务器来实现，比如travis(如果你在Github上)或Jenkins(如果你有一个私有的repo)。

对于一键式构建，直接使用capistrano(从命令行使用cap deploy)或运行所有测试的简单CI钩子，然后运行cap deploy。

相关内容

最新更新

热门标签：