Capistrano

Capistrano是一种在多台服务器上运行脚本的开源工具，它主要用于部署web应用。它自动完成多台服务器上新版本的同步更新，包括数据库的改变。Capistrano最初由Jamis Buck用Ruby开发，并用RubyGems部署渠道部署。现在Capistrano不仅限于应用Ruby on Rails的 web应用框架，而且可以用于部署用其他框架的web应用程序，比如用PHP开发的。Capistran最初是用来应用于bash指令行。现在Ruby on Rails框架的用于也可以使用它的新特性，例如，对当前web应用部署改变使其更新版本，或者使其回滚到之前的旧版本。

Capistran最初叫SwitchTower，由于商标争端于2009年二月24日改为Capistran。而且原始作者于当天宣布不再是该软件的维护者。

原始作者        Jamis Buck

稳定版         2.6.0 / 4 May. 2011

开发语言         Ruby

应用平台         POSIX (Linux, OpenBSD, Mac OS X)

类型         Deployment Tool

License         MIT

Capistrano是一种通过ssh向多个服务器部署web应用的一种框架和工具。它使用一种简单的Domain Specific Language，这种语言是从工具rake中部分借用过来的，Rake的作用类似C语言中的make工具，允许你定义任务，这些任务也许用于某些特定角色的服务器。同时它还允许你透过网关在防火墙和VPN之后执行任务。

当您完成了Rails 2.x应用后，是时候用到Capistrano了，它可以很容易的帮您自动向多台服务器同步部署应用。Capistrano的安装也很简单，只需要gem install capistrano即可。在我们有效地设置Capistrano之前，我们必须做好应用部署相关的决定，Capistrano可不能帮你解决这些问题。但是Capistrano的默认设置足以解决大部分问题。

web服务器软件

首先我们需要安装web服务器软件，可以选择的有Apache, Lighttpd, 和 nginx 如果没有特别需求，可以选择nginx，小巧而高效。

数据库

然后是数据库，你需要决定你的产品需要那款数据库软件，MySQL 和 PostgreSQL是两个不错的开源选择，即使大公司更倾向使用Oracle。有些人会选择使用SQLite，他很适合单用户的嵌入式环境，但却不适合web环境。在这些选择中，MySQL通常来说是最容易安装和设置的，所以此处推荐MySQL。

Ruby

然后是Ruby，Ruby对任何Rails应用来说都非常关键，你需要决定你要安装Ruby的版本和插件。这些年JRuby也能跑Rails，但是如果你决定用JRuby来代替MRI Ruby来部署的话，你的设置环节可能需要较大的改变。

应用层

应用层是实际运行你的web应用的环节。Mongrel是个很流行的选择，而Thin and Passenger (例如 mod_rails)也变得越来越流行。有的人会尝试使用WEBrick来部署产品，但并不推荐使用它，WEBrick用于应用的开发和测试还是不错的，但要用于大规模部署产品的生产环境可能就不太好。还需要注意的是，如果你使用Passenger之类的话，你需要确保你的web服务器软件支持他，Passenger只支持Apache2和nginx。

版本控制

虽然版本控制系统跟产品部署的设置没什么关系，但是在默认设置下，Capistrano很大程度上依赖你的版本控制系统。Capistrano支持的版本控制系统比较少，要支持更多的版本控制系统，你需要做更多地工作。最常见的Subversion和Git都能得到很好的支持，最易选一个你用的惯的它也支持的版本控制系统。

接下来我们按照如顺序配置

nginx

MySQL

MRI Ruby

Mongrel

Subversion

Capification

安装完Capistrano之后要做的第一件事就是"capify"你的应用，这个过程是设置Capistrano来部署你的应用，很简单，只需在你的应用的root目录里执行capify .(即capify+" "+ ".")。这将产生两个文件，一个是capfile，这个是Capistrano需要的主要文件，就像make自动产生makefile，rake自动产生Rakefile一样，Capistrano默认寻找并加载capfile文件，默认产生的rapfile非常小，它所做的事就是加载“config/deploy.rb"；第二个文件是"config/deploy.rb"，这个文件包含你的应用程序部署所需的设置。Ralis的所有设置文档都放在config目录下，通常，你不需要管capfile文件，只需要把精力放在config/deploy.rb的设置和优化上。如果你的Capistrano用于非Rails环境，你可能只有一个capfile文件，而没有config/deploy.rb这个文件。

Configuration

设置，如果你看看config/deploy.rb的内容，你就会发现，里面没多少可设置的东西。首先我们要告诉Capistrano我们的应用程序被"调用"了

set:application, "your_application_name"

然后我们需要告诉Capistrano我们的源代码在哪里，这个地址你的本地主机和服务器都可以到达。

set :repository, "svn+ssh://code#######/repos/your_application_name"

然后，如果你用的不是Subversion，你还需要告诉Capistrano你使用的版本控制系统：

set :scm, :git

部署目录结构

一次成功的部署将会产生如下文件目录结构：

[deploy_to]

[deploy_to]/releases

[deploy_to]/releases/20080819001122

[deploy_to]/releases/...

[deploy_to]/shared

[deploy_to]/shared/log

[deploy_to]/shared/pids

[deploy_to]/shared/system

[deploy_to]/current -> [deploy_to]/releases/20100819001122

（deploy_to代表你想让Capistrano在你的服务器部署的位置）

每部署一次，将在release目录下产生新的目录，然后新版本将在部署在那里。然后"current"链接将指向新产生的目录.

还需要注意的是，设置你的web服务器软件时要在相应的root目录下执行。

回到设置上来

接下来回到设置Capistran上来。我们需要告诉Capistran我们的应用放在服务器的哪里。默认是在"/u/apps/#{application}"。但是你也许想在/var/www上部署，这就需要这样设置：

set :deploy_to, "/var/www"

然后在告诉Capistrano我们的服务器在哪儿，各自都起到什么作用：

role :app, "tutorial#com"

role :web, "tutorial#com"

role :db, "tutorial#com", :primary => true

如果只有一个服务器，就这样设置：

server "tutorial#com", :app, :web, :db, :primary => true

app,web,db是Capistrano需要的三种角色：

web：你的服务器软件运行的地方；

app：你的应用层运行的地方；

db：迁移运行的地方；

杂项配置

以上的设置对大部分人来说已经足够了，下面是额外的附加设置，如果你确实需要的话:

set :user, “foo”如果你你登录的用户名与你登录本地的用户名不一致，你需要告诉Capistrano你的用户名；

set :scm_username, “foo”如果你登录你的源代码库时使用的用户名与你登录本地的用户名不一致时，你需要告诉Capistrano。注意到并不是所有的版本控制系统都支持scm_username变量，你可能需要在你的库中嵌入scm_usernam：e.g. “svn+ssh://#{scm_username}@foo.bar#com/path/to/repo”

set :use_sudo, false，在默认情况下，Capistrano会尝试使用sudo即管理员权限执行命令，在你不具备sudo权限的时候，这可能会是个问题，需要引起足够注意。

与Capistrano会话

设置完成之后，我们可以”问问“Capistrano一些问题，看看基本信息：

$ cap -h 显示Capistrano自身相关信息；

$ cap -H 显示更多信息；

$ cap -T 显示tasks

设置服务器

开始正常工作之前，我们需要让Capistrano建立基本的目录树：

$ cap deploy:setup

检查依赖性：

$ cap deploy:check我们在相应的位置新建了相应的目录结构，然后我们需要让Capistrano所需的依赖关系是否都得到满足

数据库初始化

接下来是要确定数据库已经准备好了，安装设置完之后，还需要确认一下三件事：

1）你是否已经为你的部署新建了数据库？

2）你是否已经为你的config/database.yml文件添加了相应的部分？

3）你是否为你的数据库设置了足够的权限？

Capistrano启动应用层之前，他首先会执行script目录下的spin脚本，脚本内容如下：

#!/bin/sh

#{deploy_to}/current/script/process/spawner \

mongrel \

--environment=production \

--instances=1 \

--address=127.0.0.1 \

--port=#{port}

把#{deploy_to}对换成相应的完整路径

#{port}是你想让mongrel监听的端口

接下来就该部署了

$ cap deploy:update

这个指令将把你的源代码复制到你的服务器上，然后把current这个链接更新到最新的目录下。但是这会儿还没正式启动应用层。这一步成功之后，就会登录到你的服务器，然后把当前目录定位到你的新版本里，即[deploy_to]/current，首先上载数据库架构到数据库里：

$ rake RAILS_ENV=production db:schema:load

如果这一步成功完成，可以用下面的指令来测试下：

$ script/console production

如果测试成功，会产生如下命令提示符：

>> app.get("/")

最后，启动应用层，看看动态内容是否被成功加载：

$ cap deploy:start

这将会冷启动应用层，这个过程中使用了上述spin脚本

重启和重新部署

$ cap deploy:restart

然后正式部署：

$ cap deploy