server$ mkdir deploy/shared

现在如果我们执行cap deploy:web:disable，capistrano会通过sftp上传一个默认的站点维护页面到shared/system /maintenance.html，而deploy:web:enable则会将这个页面删除，但是这个任务本身并不能将应用屏蔽掉，我们需要修改前端服务器的rewrite规则。

如果你使用nginx，那么加入下面几行到你的nginx.conf：


server {
  root /current/deploy/path/public;
  if (-f $document_root/system/maintenance.html) {
    set $maintenance 1;
  }
  if ($request_uri ~* (jpg|jpeg|gif|js|css)$) {
    set $maintenance 0;
  }
  if ($maintenance) {
    rewrite ^(.*)$ /system/maintenance.html last;
    break;
  }
  location / {
    ....

这样nginx会首先判断维护页面是否存在，如果存在，则将所有清除都转向维护页面，如果使用apache，则需要修改.htaccess（未验证）：

RewriteCond %{REQUEST_URI} !\.(css|jpg|js|gif|png)$
RewriteCond %{DOCUMENT_ROOT}/system/maintenance.html -f
RewriteCond %{SCRIPT_FILENAME} !maintenance.html
RewriteRule ^.*$ /system/maintenance.html [L]

如果你想要这一切自动进行，那么你可以将这两个任务加入deploy任务：


namespace :deploy do
  desc "Default deploy will update the code without migrate the database and restart the servers"
  task :default do
    # put up the maintenance screen
    web.disable
    transaction do
      update_code
      symlink
      copy_configs
    end
    restart
    # remove the maintenance screen
    web.enable
  end
end

如果你想要自定义维护页面，可以通过覆盖默认的deploy:web:disable任务实现：


namespace :deploy do
  namespace :web do
    task :disable do
      on_rollback { delete "#{shared_path}/system/maintenance.html" }
      require 'rubygems'
      require 'haml'
      template = File.read("./app/views/layouts/maintenance.html.haml")
      haml = Haml::Engine.new(template)
      maintenance = haml.render(Object.new,
        :deadline => ENV['UNTIL'],
        :reason => ENV['REASON'])
      put maintenance, "#{shared_path}/system/maintenance.html",
        :mode => 0644
    end
  end
end

这段代码渲染了layouts/maintenance.html.haml，你可以根据自己的需要定义它，这里我们传入了两个变量，一个指定原因，一个指定恢复时间:


%h1
  We're currently down for
  = reason ? reason : "maintenance"
  as of
  = Time.now.strftime("%H:%M %Z")
%p
  Sorry for the inconvenience. We'll be back
  = deadline ? "by #{deadline}" : "shortly"
  Please email us if you need to get in touch.

你可以在执行deploy:web:disable之前设定这两个变量：

UNTIL=”16:00 MST” REASON=”a database upgrade” cap disable_web

参考：

• http://clarkware.com/cgi/blosxom/2007/01/05
• http://www.ruby-forum.com/topic/113740
• http://www.mail-archive.com/haml@googlegroups.com/msg02726.html

安装PCRE库:

$ ftp ftp.csx.cam.ac.uk
username: anonymous
> cd pub/software/programming/pcre/
> get pcre-7.4.tar.bz2

> quit
$ tar -jxvf pcre-7.4.tar.bz2
$ cd pcre-7.4
$ ./configure
$ make

不需要安装它，只是编译nginx时需要用到而已。

安装nginx

$ wget http://sysoev.ru/nginx/nginx-0.5.32.tar.gz

$ tar -zxvf nginx-0.5.32.tar.gz
$ cd nginx-0.5.32
$ ./configure --with-pcre=../pcre-7.4
$ make
$ sudo make install

配置nginx

修改/usr/local/nginx/conf/nginx.conf:

user  someuser;
worker_processes  1;

error_log logs/error.log  notice;

pid logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       conf/mime.types;
    default_type  application/octet-stream;

    access_log  logs/access.log;

    sendfile        on;
    tcp_nopush     on;

    keepalive_timeout  65;
    tcp_nodelay        on;

    gzip  on;
    gzip_min_length  1100;
    gzip_buffers     4 8k;
    gzip_types       text/plain;

    upstream mongrel {
        server 127.0.0.1:8100;
        server 127.0.0.1:8101;
        server 127.0.0.1:8102;
        server 127.0.0.1:8103;
    }

    server {
        listen       80;
        server_name  your.server.com;
        location / {
            proxy_pass http://mongrel;
        }

        root /home/your/app/path;

        access_log  off;
        rewrite_log on;

        location ~ ^/$ {
            if (-f /index.html){
                rewrite (.*) /index.html last;
            }
            proxy_pass  http://mongrel;
            proxy_set_header   Host             $host;
        }

        location / {
            if (!-f $request_filename.html) {
                proxy_pass  http://mongrel;
            }
            rewrite (.*) $1.html last;
        }

        location ~ .html {
            root /home/your/app/path;
        }

        location ~* ^.+.(jpg|jpeg|gif|png|ico|css|zip|tgz|gz|rar|bz2|doc|xls|
                                 exe|pdf|ppt|txt|tar|mid|midi|wav|bmp|rtf|js|mov)$ {
            root /home/your/app/path;
        }
        location / {
            proxy_pass  http://mongrel;
            proxy_redirect     off;
            proxy_set_header   Host             $host;
            proxy_set_header   X-Real-IP        $remote_addr;
            proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;
        }
    }
}

启动 nginx

$ sudo /usr/local/nginx/sbin/nginx

配置启动 mongrel cluster

$ cd /home/your/app/path
$ sudo mongrel_rails cluster::configure -e production \
-p 8100 -N 4 -c /home/your/app/path -a 127.0.0.1 \
--user mongrel --group mongrel
$ sudo mongrel_rails cluster::start

配置 HTTP 认证

添加以下行到 nginx.conf:

location  /  {
    auth_basic            "Restricted";
    auth_basic_user_file  conf/htpasswd;
}

要生成htpasswd文件, 使用Apache附带的htpasswd命令:

$ sudo htpasswd -bc conf/htpasswd user pass

关于htpasswd命令的使用，可使用’htpasswd -h’察看帮助。

清理工作

$ rm -rf pcre-7.4
$ rm -rf nginx-0.5.32

更新：如果遇到redirect_to重定向问题，请检查你的nginx版本，老版本使用$http_host变量，因此应该对proxy_set_header做相应修改：

    proxy_set_header   Host             $host;

听到Rails部署这两词，可能你首先想到的是下面这堆东西：

• CGI
• Apache1.3/mod_fastcgi
• Lighttpd/fcgi
• Apache2/mod_fcgid
• Lighttpd/SCGI
• Lightspeed

但时代已经变了，新时代需要新思维

Mongrel：The year of the dog

Mongrel是由Zed Shaw完成的一个HTTP Server，它：

• 使用Ragel + C的快速HTTP解析
• 使用C的快速URI过滤器
• 堆栈式请求处理
• 配置灵活
• 安全同时兼容RFC的HTTP解析器

Mongrel就足够了？

答案是：不够，因为：

• Rails请求分发需要使用互斥锁
• 一个Mongrel实例只能同时处理一个请求
• 需要使用Mongrel_cluster创建多个实例来获取可伸缩性

因此，你仍然需要一个前端HTTP Server，幸好有一大堆：

• Pen，Pound，Balance，Haproxy（不支持静态文件，只是代理）
• Lightspeed，支持静态文件和代理
• Apache2.2.x/mod_proxy_balancer，同上

这就搞定了？还不行：

• Pen（不支持SSL，不能限制连接速率）
• Pound（不支持高负载，不能限制链接速率）
• Haproxy（可限制连接速率，性能非常高，不支持静态文件
• Lightspeed，免费版功能严重残缺
• Apache2.2.x，没什么不好，就是：太臃肿了

那怎么办？

Nginx：From Russia, with Love

Nginx有什么好处：

• 专为性能优化而开发，性能是其最重要的考量
• 非常小的资源占用
• 经过考验的高负载支持，没有内存泄漏
• 杀手级的Rewrite及Proxy模块
• 平易近人的作者以及快速扩大的社区

答案有了：Nginx + Mongrel，现在

• Apache很清闲了，它只需要负责mod_dav_svn就可以了
• 灵活的nginx.conf语法可以很轻易的搞定Rails Cache及动态请求
• 还有就是：快，快，快
• 我有说过快吗？

当然还有一些问题：

• Nginx会自动缓冲文件上传，因此将失去mongrel_upload_progress支持
• Proxy模块暂时还不支持链接速率限制

完美的部署就这样产生了：

• Linux
• Nginx
• Mongrel(Mongrel_cluster)
• Monit

就这么完了？还有一点，上面讲到过Mongrel的问题：

• 不能同时处理多个请求
• Rails分发需要取得互斥锁，
• 还有多线程切换

这些都会损耗性能，因此我们需要新思维

Swiftiply: Evented Mongrel

Swiftply事实上是Mongrel的修订版，那么它对Mongrel做了什么：

• 去除了Mongrel中对线程和Socket的处理
• 使用EventMachine的事件循环来代替
• Mongrel成了单线程，事件驱动
• 显著的速度及IO吞吐量提升
• 即使高并发，也没有不良症状（性能下降及内存泄漏）

你可能疑惑为何单线程会优于多线程，这是因为：

• Ruby的绿色线程进行上下文切换时需要拷贝大量的状态信息
• 互斥锁非常昂贵
• 单个进程的IO吞吐量有限
• 事件驱动意味着更紧凑的循环已经回调处理
• 由于节省了进程切换的时间，因此单线程可以将更多的精力集中到网络IO上。

Swiftiply还有一个好处：它可以启动多个Mongrel，但只使用一个端口。

总算结束了，原文还有一部分是关于虚拟机和磁盘阵列的，对这部分不是很熟悉，所以没有翻，有兴趣的可以看原文：Xen and the Art of Rails Deployment