部署 unicorn 使用简介

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

Unicorn 是什么?

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

特性:

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

使用:

  1. 非 Rails Rack 应用程序: unicorn
  2. Rails 应用程序(支持 Rails 1.2 及之后的版本) unicorn_rails

参数说明:

  1. unicorn 会默认绑定到 8080 端口,可以使用 --listen/-l 来选择到不同的 address:port 或者使用 UNIX socket.
  2. -D 以 Deamon 形式启动
  3. -c 设定配置文件,如我们的 /workspace/project_name/config/unicorn.rb
  4. -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

参考:

  1. http://unicorn.bogomips.org/
  2. http://blog.kiskolabs.com/post/722322392/unicorn-init-scripts
  3. http://codetunes.com/2012/06/20/nginxunicorn-configuration-for-multi-app-servers
  4. http://sirupsen.com/setting-up-unicorn-with-nginx/

说明:

  1. 请把 project_name 改成自己项目的名称
  2. 简单的先放着,因为有其他任务,后续再调格式
  3. 因为是自己研究的,有不对的地方,请大家指教,后续也会继续更新的。

支持...为什么 rails 一直没有一个最好服务器方案呢?老在变

#1 楼 @evan 不是再变,而是不断有更好的出来

没有最好,只有更好!

#1 楼 @evan 流水不腐,户枢不蠹

好文章,适合科普。

k,这篇文章太打动我了,之前对 unicorn 完全没有关注过,现在看来很威武

unicorn 现在是主流了,github 在 09 年就开始在用:https://github.com/blog/517-unicorn

比 passenger 好?

好文章。

Rails 项目用 unicorn, Python 项目用 gunicorn, 然后用 supervisor 去管理它们。

好文章。

实践证明sig 0会一直返回 False,导致 upgrade 功能失败。有懂行的人解释下为什么么?

需要 登录 后方可回复, 如果你还没有账号请 注册新账号