部署 unicorn 使用简介

luoping0425 · 2012年08月02日 · 最后由 hardywu 回复于 2013年11月17日 · 28253 次阅读

Unicorn 是什么？

为 Rack 应用程序设计的 HTTP server
是一个利用 Unix 的高级特性开发的
为具备低延迟，高带宽的连接的客户服务

特性：

为 Rack，Unix，快速的客户端和易调试而设计。
完全兼容 Ruby 1.8 和 1.9。
进程管理：Unicorn 会获取和重启因应用程序出错导致死亡的任务，不需要自己管理多个进程和端口。Unicorn 可以产生和管理任何数量的任务进程。
负载均衡完全由操作系统 (Unix) 核心完成。在繁忙的任务进程时，请求也不会堆积。
不需要关心应用程序是否是线程安全的，workers 运行在特们自己独立的地址空间，且一次只为一个客户端服务。
支持所有的 Rack 应用程序。
使用 USR1 信号来固定重复打开应用程序的所有日志文件。Unicorn 也可以逐步的确定一个请求的多行日志放在同一个文件中。
nginx 式的二进制升级，不丢失连接。你可以升级 Unicorn、你的整个应用程序、库、甚至 Ruby 编辑器而不丢失客户端连接。
在 fork 进程时如果由特殊需求可以使用 before_fork 和 after_fork。如果“preload_app“为 false 时，则不能使用。
可以使用 copy-on-wirte-friendly 内存管理来节约内容（通过设置“preload_app" 为 true）。
可以监听多接口，包括：UNIX sockets，每个 worker process 也可以在简单调试时通过 after_fork 钩子绑定到私有的端口。
配置使用简单易用的 Ruby DSL。

安装：

$ gem install unicorn

配置：

# 设定 GEM_HOME
GEM_HOME = "/Users/P.Luo/.rvm/gems/ruby-1.8.7-p340@project_name"

# 获取当前项目路径
require 'pathname'
path = Pathname.new(__FILE__).realpath # 当前文件完整路径
path = path.sub('/config/unicorn.rb', '')
APP_PATH = path.to_s

# 或直接填写
# APP_PATH = "/path_to_project/workspace/project_name"

# worker 数
worker_processes 20

# 项目目录，部署后的项目指向 current，如：/srv/project_name/current
working_directory APP_PATH 

# we use a shorter backlog for quicker failover when busy
# 可同时监听 Unix 本地 socket 或 TCP 端口
listen "/tmp/project_name.sock", :backlog => 64
# 开启tcp 端口，可不使用 apache 或 nginx 做代理，直接本地：http://localhost:port
#listen 8080, :tcp_nopush => true

# 如果为 REE，则添加 copy_on_wirte_friendly
# http://www.rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
if GC.respond_to?(:copy_on_write_friendly=)
  GC.copy_on_write_friendly = true
end

# request 超时时间，超过此时间则自动将此请求杀掉，单位为秒
timeout 180

# unicorn master pid
# unicorn pid 存放路径
pid APP_PATH + "/tmp/pids/unicorn.pid"

# unicorn 日志
stderr_path APP_PATH + "/log/unicorn.stderr.log"
stdout_path APP_PATH + "/log/unicorn.stdout.log"

preload_app true

before_fork do |server, worker|
  defined?(ActiveRecord::Base) and
    ActiveRecord::Base.connection.disconnect!
end

after_fork do |server, worker|
  defined?(ActiveRecord::Base) and
    ActiveRecord::Base.establish_connection
end

使用：

非 Rails Rack 应用程序： unicorn
Rails 应用程序（支持 Rails 1.2 及之后的版本） unicorn_rails

参数说明：

unicorn 会默认绑定到 8080 端口，可以使用 --listen/-l 来选择到不同的 address:port 或者使用 UNIX socket.
-D 以 Deamon 形式启动
-c 设定配置文件，如我们的 /workspace/project_name/config/unicorn.rb
-E 设定生产环境或开发环境，如 -E production

例：

$ unicorn_rails -E production -D -c /srv/project_name/current/config/unicorn.rb

重启：方法一：

$ ps auwx | grep unicorn

获取：master 的 pid 如

$ kill -9 17357
$ unicorn_rails -E production -D -c /srv/project_name/current/config/unicorn.rb

方法二：在/etc/init.d/ 目录下添加 init 脚本：

$ sudo /etc/init.d/unicorn.project_name
Usage: /etc/init.d/unicorn.project_name <start|stop|restart|upgrade|force-stop|reopen-logs>

可以运行：sudo /etc/init.d/unicorn.project_name 来进行项目重启、停止、启动...

init 脚本示例（请更改 APP_ROOT －项目目录和 APP_USER －项目所属用户的值）：

#!/bin/sh
set -e

# Feel free to change any of the following variables for your app:
TIMEOUT=${TIMEOUT-60}
APP_ROOT=/srv/project_name/current
APP_USER=username
PID=$APP_ROOT/tmp/pids/unicorn.pid
ENV=production
CMD="bundle exec unicorn_rails -E $ENV -D -c $APP_ROOT/config/unicorn.rb"
action="$1"
set -u

old_pid="$PID.oldbin"
cd $APP_ROOT || exit 1

sig (){
        test -s "$PID" && kill -$1 `cat $PID`
}

oldsig (){
        test -s $old_pid && kill -$1 `cat $old_pid`
}
case $action in
start)
        sig 0 && echo >&2 "Already running" && exit 0
        su $APP_USER -c "$CMD"
        ;;
stop)
        sig QUIT && exit 0
        echo >&2 "Not running"
        ;;
force-stop)
        sig TERM && exit 0

        echo >&2 "Not running"
        ;;
restart|reload)
        sig HUP && echo reloaded OK && exit 0
        echo >&2 "Couldn't reload, starting '$CMD' instead"
        su $APP_USER -c "$CMD"
        ;;
upgrade)
        if sig USR2 && sleep2 && sig 0 && oldsig QUIT
        then
                n=$TIMEOUT
                while test -s $old_pid && test $n -ge 0
                do
                        printf '.' && sleep 1 && n=$(($n - 1))
                done
                echo

                if test $n -lt 0 && test -s $old_pid
                then
                        echo >&2 "$old_pid still exists after $TIMEOUT seconds"
                        exit1
                fi
                exit0
        fi
        echo >&2 "Couldn't upgrade, starting '$CMD' instead"
        su $APP_USER -c "$CMD"
        ;;
reopen-logs)
        sig USR1
        ;;*)
        echo >&2 "Usage: $0 <start|stop|restart|upgrade|force-stop|reopen-logs>"
        exit 1
        ;;
esac