在 Ubuntu 12.04 Server 上安装部署 Ruby on Rails 应用 实用过程

实时更新

前言

本教程只适合 Ubuntu Server 用于部署项目到线上，建议使用同样的 Ubuntu 版本，以免遇到一些版本不同带来的问题。

本教程适合新手初次部署 Rails 应用；

本文测试通过环境
Ubuntu 12.04 Server，

服务器安装测试于 Linode VPS （Ubuntu 12.04 LTS (GNU/Linux 3.4.2-x86_64-linode25 x86_64)。

配置 Ubuntu Server 系统
如果你是国内服务器，推荐修改网易的源
输入 sudo vi /etc/apt/sources.list 将里面的内容替换成：
deb http://mirrors.163.com/ubuntu/ precise main restricted universe multiverse
deb http://mirrors.163.com/ubuntu/ precise-security main restricted universe multiverse
deb http://mirrors.163.com/ubuntu/ precise-updates main restricted universe multiverse
deb http://mirrors.163.com/ubuntu/ precise-proposed main restricted universe multiverse
deb http://mirrors.163.com/ubuntu/ precise-backports main restricted universe multiverse
deb-src http://mirrors.163.com/ubuntu/ precise main restricted universe multiverse
deb-src http://mirrors.163.com/ubuntu/ precise-security main restricted universe multiverse
deb-src http://mirrors.163.com/ubuntu/ precise-updates main restricted universe multiverse
deb-src http://mirrors.163.com/ubuntu/ precise-proposed main restricted universe multiverse
deb-src http://mirrors.163.com/ubuntu/ precise-backports main restricted universe multiverse
然后更新一下:
$ sudo apt-get update
安装必要的三方库

$ sudo apt-get install -y wget vim build-essential openssl libreadline6 libreadline6-dev libmysqlclient-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libxml2-dev libxslt-dev libcurl4-openssl-dev autoconf automake libtool imagemagick libmagickwand-dev libpcre3-dev nodejs libpq-dev

安装 Ruby, Rails 及相关

安装 RVM
$ \curl -L https://get.rvm.io | bash -s stable
$ echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm"' >>~/.bashrc
$ source ~/.bashrc

$ rvm -v

安装 Ruby
如果你是国内服务器，推荐将 RVM 的安装源替换成 Taobao 的镜像服务器，这样安装能更快！
$ sed -i -e 's/ftp\.ruby-lang\.org\/pub\/ruby/ruby\.taobao\.org\/mirrors\/ruby/g' ~/.rvm/config/db
用 RVM 安装 Ruby:
$ rvm pkg install readline openssl
$ rvm install 2.0.0
$ rvm use 2.0.0 --default
$ ruby -v
ruby 2.0.0p247
国内服务器推荐替换 RubyGems 的到淘宝镜像:
$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***
http://ruby.taobao.org
安装 Rails
$ gem install rails
$ rails -v
Rails 4.0.0
注意：安装过程中会出现很多状况，还可以通过rbenv来管理ruby 和 rails的安装。详情查阅资料。
http://ruby-china.org/wiki/rbenv-guide
http://blog.csdn.net/yiyunhzy/article/details/10232395


安装 MySQL 或其他数据库
当然，如果你的项目是用的其他数据库，请自己解决
$ sudo apt-get install mysql-server
跟着提示安装，此处涉及东西在本教程之外，请自行 Google 相关教程解决。


部署你的网站
接下来你可以通过 Git 或其他方式将你项目的源代码提交到服务器上面，建议放到用户的 ~/www 下面。
为了方便教程，我们假设，用户是 jason (拥有 sudo 权限), 项目名 gitlab 后面遇到类似的地方请更具自己的情况修改
$ cd ~/
$ pwd
/home/jason/
$ mkdir www
$ cd www
$ git clone git@you.host:gitlab.git
$ cd gitlab
$ bundle install
修改你的数据库配置，创建数据库，合并 migration ...这些是 Rails 开发的基础，这里就不细说了，重点是最后你能让你的项目能用 rails s 跑起来！
$ rails s -e production
安装 Passenger 用于部署 Rails 应用
$ gem install passenger
$ passenger -v
Phusion Passenger version 4.0.10
由于 Passenger 需要重新编译 Nginx，如果你之前有安装 Nginx 需要卸载掉！
nginx -v，有的话卸载 $ sudo apt-get remove nginx-common nginx-full nginx
用 Passenger 安装 Nginx
$ sudo passenger-install-nginx-module
接下来会出现提示，选择 Yes: download, compile and install Nginx for me. (recommended) ，对于后面的提示一直选默认哪项，敲回车。
最后看到
Nginx with Passenger support was successfully installed.
表示你人品很好 Nginx 安装成功！否则请看 Passenger 官方安装文档 自行解决……


如果没有成功，就手动下载Nginx，然后执行
$ sudo passenger-install-nginx-module

在选择安装方式是选择2，就是手动安装，输入你的nginx地址后一直默认执行下去就OK。

安装 Nginx init script
接下来你需要安装 Nginx 的启动脚本，以及配置开机自动启动
$ cd ~/
$ git clone git://github.com/jnstq/rails-nginx-passenger-ubuntu.git
$ sudo mv rails-nginx-passenger-ubuntu/nginx/nginx /etc/init.d/nginx
$ sudo chmod +x /etc/init.d/nginx
配置 Nginx 开机自启动

$ sudo update-rc.d nginx defaults

配置 Nginx 与网站
打开 Nginx 的 nginx.conf
$ sudo vim /opt/nginx/conf/nginx.conf
PS: 如果你不是 Passenger 安装的 Nginx，这个配置文件还有可能在 /usr/local/nginx/ 或 /etc/nginx 下面
请参考下面的例子修改：
user jason; # 修改成你的系统帐号名，不然项目目录 /home/jason/www 这里没有权限
worker_processes 8; # 修改成和你 CPU 核数一样
pid /var/run/nginx.pid;
http {
  include       mime.types;
  default_type  application/octet-stream;
  client_max_body_size 50m;
  sendfile        on;
  access_log /var/log/nginx/access.log;
  error_log /var/log/nginx/error.log;
  gzip on;
  gzip_disable "msie6";
  ## ------------ 重点修改内容 --------
  server {    
    # 此处用于防止其他的域名绑定到你的网站上面
    listen 80 default;
    return 403;
  }
  server {
    listen       80;
    server_name  you.host.name; # 请替换成你网站的域名
    rails_env    production;
    root         /home/jason/www/gitlab/public;
    passenger_enabled on;
    location ~ ^(/assets) {
      access_log        off;
      # 设置 assets 下面的浏览器缓存时间为最大值（由于 Rails Assets Pipline 的文件名是根据文件修改产生的 MD5 digest 文件名，所以此处可以放心开启）
      expires           max; 
    }
  }
  ## ---------------------------------
}
重启 Nginx
$ sudo /etc/init.d/nginx start

部署完成！可以尝试访问你的域名。

说明：nginx代替rails s命令对rails程序进行了代理运行，特别注意80端口被nginx默认占用，所以rails s指定80端口时会提示断口占用的错误提示。注意配置文件server里面的内容就知道，里面是关于程序具体运行所要填写的配置信息，需要重点搞清楚。

注意：在配置文件里面给出的passenger_root是默认的，也是非常实用的，一般不需要改。自动生成的配置文件里，关于passenger_ruby部分也是默认，但是有可能和你的项目版本不同，有可能进行修改。通过我个人的经历，认为只要找到ruby的安装目录和执行程序，把它手动链接到/usr/bin/目录下面，以该ruby版本的具体版本名命令，这样就比较好了。

附件：
Nginx配置文件详细说明
在此记录下Nginx服务器nginx.conf的配置文件说明, 部分注释收集与网络.
#运行用户
user www-data;    
#启动进程,通常设置成和cpu的数量相等
worker_processes  1;
#全局错误日志及PID文件
error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;
#工作模式及连接数上限
events {
    use   epoll;             #epoll是多路复用IO(I/O Multiplexing)中的一种方式,但是仅用于linux2.6以上内核,可以大大提高nginx的性能
    worker_connections  1024;#单个后台worker process进程的最大并发链接数
    # multi_accept on; 
}
#设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
     #设定mime类型,类型由mime.type文件定义
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    #设定日志格式
    access_log    /var/log/nginx/access.log;
    #sendfile 指令指定 nginx 是否调用 sendfile 函数（zero copy 方式）来输出文件，对于普通应用，
    #必须设为 on,如果用来进行下载等应用磁盘IO重负载应用，可设置为 off，以平衡磁盘与网络I/O处理速度，降低系统的uptime.
    sendfile        on;
    #tcp_nopush     on;
    #连接超时时间
    #keepalive_timeout  0;
    keepalive_timeout  65;
    tcp_nodelay        on;
    
    #开启gzip压缩
    gzip  on;
    gzip_disable "MSIE [1-6]\.(?!.*SV1)";
    #设定请求缓冲
    client_header_buffer_size    1k;
    large_client_header_buffers  4 4k;
    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
    #设定负载均衡的服务器列表
     upstream mysvr {
    #weigth参数表示权值，权值越高被分配到的几率越大
    #本机上的Squid开启3128端口
    server 192.168.8.1:3128 weight=5;
    server 192.168.8.2:80  weight=1;
    server 192.168.8.3:80  weight=6;
    }
   server {
    #侦听80端口
        listen       80;
        #定义使用www.xx.com访问
        server_name  www.xx.com;
        #设定本虚拟主机的访问日志
        access_log  logs/www.xx.com.access.log  main;
    #默认请求
    location / {
          root   /root;      #定义服务器的默认网站根目录位置
          index index.php index.html index.htm;   #定义首页索引文件的名称
          fastcgi_pass  www.xx.com;
         fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name; 
          include /etc/nginx/fastcgi_params;
        }
    # 定义错误提示页面
    error_page   500 502 503 504 /50x.html;  
        location = /50x.html {
        root   /root;
    }
    #静态文件，nginx自己处理
    location ~ ^/(images|javascript|js|css|flash|media|static)/ {
        root /var/www/virtual/htdocs;
        #过期30天，静态文件不怎么更新，过期可以设大一点，如果频繁更新，则可以设置得小一点。
        expires 30d;
    }
    #PHP 脚本请求全部转发到 FastCGI处理. 使用FastCGI默认配置.
    location ~ \.php$ {
        root /root;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME /home/www/www$fastcgi_script_name;
        include fastcgi_params;
    }
    #设定查看Nginx状态的地址
    location /NginxStatus {
        stub_status            on;
        access_log              on;
        auth_basic              "NginxStatus";
        auth_basic_user_file  conf/htpasswd;
    }
    #禁止访问 .htxxx 文件
    location ~ /\.ht {
        deny all;
    }
     
     }
}
以上是一些基本的配置,使用Nginx最大的好处就是负载均衡
如果要使用负载均衡的话,可以修改配置http节点如下：
#设定http服务器，利用它的反向代理功能提供负载均衡支持
http {
     #设定mime类型,类型由mime.type文件定义
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    #设定日志格式
    access_log    /var/log/nginx/access.log;
    #省略上文有的一些配置节点
    #。。。。。。。。。。
    #设定负载均衡的服务器列表
     upstream mysvr {
    #weigth参数表示权值，权值越高被分配到的几率越大
    server 192.168.8.1x:3128 weight=5;#本机上的Squid开启3128端口
    server 192.168.8.2x:80  weight=1;
    server 192.168.8.3x:80  weight=6;
    }
   upstream mysvr2 {
    #weigth参数表示权值，权值越高被分配到的几率越大
    server 192.168.8.x:80  weight=1;
    server 192.168.8.x:80  weight=6;
    }
   #第一个虚拟服务器
   server {
    #侦听192.168.8.x的80端口
        listen       80;
        server_name  192.168.8.x;
      #对aspx后缀的进行负载均衡请求
    location ~ .*\.aspx$ {
         root   /root;      #定义服务器的默认网站根目录位置
          index index.php index.html index.htm;   #定义首页索引文件的名称
          proxy_pass  http://mysvr ;#请求转向mysvr 定义的服务器列表
          #以下是一些反向代理的配置可删除.
          proxy_redirect off;
          #后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          client_max_body_size 10m;    #允许客户端请求的最大单文件字节数
          client_body_buffer_size 128k;  #缓冲区代理缓冲用户端请求的最大字节数，
          proxy_connect_timeout 90;  #nginx跟后端服务器连接超时时间(代理连接超时)
          proxy_send_timeout 90;        #后端服务器数据回传时间(代理发送超时)
          proxy_read_timeout 90;         #连接成功后，后端服务器响应时间(代理接收超时)
          proxy_buffer_size 4k;             #设置代理服务器（nginx）保存用户头信息的缓冲区大小
          proxy_buffers 4 32k;               #proxy_buffers缓冲区，网页平均在32k以下的话，这样设置
          proxy_busy_buffers_size 64k;    #高负荷下缓冲大小（proxy_buffers*2）
          proxy_temp_file_write_size 64k;  #设定缓存文件夹大小，大于这个值，将从upstream服务器传
       }
     }

}

附件2：
Rails development server on port 80
 254 views
rails
sudo
rbenv
Sometimes you just have to run the rails development server on port 80 for whatever reason. Could be a callback that can only be posted to port 80. Or it is something else.
This is how it is done, at first you need to configure your $hell of choice. In my case the below code goes into my ~/.zshrc but in your case it could be ~/.bash_profile.
export PATH=/usr/local/bin:$PATH
export PATH=/usr/local/sbin:$PATH
export PATH="$HOME/.rbenv/bin:$PATH"
if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi
function rbenvsudo(){
  executable=$1
  shift 1
  sudo $(rbenv which $executable) $*
}
Reload your shell with source ~/.zshrc and now you can run commands as sudo with.
rbenvsudo bundle exec rails s -p 80 production