快速部署Python應用：Nginx+uWSGI配置詳解

在PHP里，最方便的就是deployment了，只要把php文件丟到支持PHP的路徑里面，然后訪問那個路徑就能使用了；無論給主機添加多少PHP應用，只要把目錄改好就沒你的事了，完全不用關心php-cgi運行得如何，deployment極為方便。

反觀Python，部屬起來真是頭痛，常見的部署方法有：

◆fcgi：用spawn-fcgi或者框架自帶的工具對各個project分別生成監聽進程，然后和http服務互動。

◆wsgi：利用http服務的mod_wsgi模塊來跑各個project。

無論哪種都很麻煩，apache的mod_wsgi配置起來很麻煩，內存占用還大，如果要加上nginx作為靜態頁面的服務器那就更麻煩了；我的應用基本上到后來都是是各個project各自為戰，且不說管理上的混亂，這樣對負載也是不利的，空閑的project和繁忙的project同樣需要占用內存。

如果Python中能有個什么東西像php-cgi一樣監聽同一端口，進行統一管理和負載平衡，那真是能省下大量的部署功夫。偶然看到了uWSGI，才發現居然一直不知道有那么方便地統一部署工具。uWSGI，既不用wsgi協議也不用fcgi協議，而是自創了一個uwsgi的協議，據說該協議大約是fcgi協議的10倍那么快，有個比較見下圖：

uWSGI的主要特點如下：

◆超快的性能。

◆低內存占用（實測為apache2的mod_wsgi的一半左右）。

◆多app管理。

◆詳盡的日志功能（可以用來分析app性能和瓶頸）。

◆高度可定制（內存大小限制，服務一定次數后重啟等）。

正式開工

uwsgi的文檔雖然很多也很詳細，這里是uwsgi的官方文檔：http://projects.unbit.it/uwsgi/wiki/Doc。

1.安裝uwsgi

ubuntu有uwsgi的ppa：

add-apt-repository ppa:stevecrozz/ppa
apt-get update
apt-get install uwsgi

2. 用uwsgi代替mod_wsgi

Nginx的整體配置說來話長，這里不再多說，假設已經明白Nginx的基本配置，那么uwsgi就類似這么配置：

location / {
  include uwsgi_params
  uwsgi_pass 127.0.0.1:9090
}

這就是把所有url傳給9090端口的uwsgi協議程序來互動。再到project目錄建立myapp.py，使得application調用框架的wsgi接口，比如web.py就是：

......
app = web.application(urls, globals())
appapplication = app.wsgifunc()

再比如django就是：

.......
from django.core.handlers.wsgi import WSGIHandler
application = WSGIHandler()

然后運行uwsgi監聽9090，其中-w后跟模塊名，也就是剛才配置的myapp

uwsgi -s :9090 -w myapp

運行網站發現已經部署完成了。

3.uwsgi的參數

以上是單個project的最簡單化部署，uwsgi還是有很多令人稱贊的功能的，例如：

並發4個線程：

uwsgi -s :9090 -w myapp -p 4

主控制線程+4個線程：

uwsgi -s :9090 -w myapp -M -p 4

執行超過30秒的client直接放棄：

uwsgi -s :9090 -w myapp -M -p 4 -t 30

限制內存空間128M：

uwsgi -s :9090 -w myapp -M -p 4 -t 30 --limit-as 128

服務超過10000個req自動respawn：

uwsgi -s :9090 -w myapp -M -p 4 -t 30 --limit-as 128 -R 10000

后台運行等：

uwsgi -s :9090 -w myapp -M -p 4 -t 30 --limit-as 128 -R 10000 -d uwsgi.log

4.為uwsgi配置多個站點

為了讓多個站點共享一個uwsgi服務，必須把uwsgi運行成虛擬站點：去掉“-w myapp”加上”–vhost”：

uwsgi -s :9090 -M -p 4 -t 30 --limit-as 128 -R 10000 -d uwsgi.log --vhost

然后必須配置virtualenv，virtualenv是Python的一個很有用的虛擬環境工具，這樣安裝：

apt-get install Python-setuptools
easy_install virtualenv

然后設置一個/多個app基准環境：

virtualenv /var/www/myenv

應用環境，在此環境下安裝的軟件僅在此環境下有效：

source /var/www/myenv/bin/activate
pip install django
pip install mako
...

最后配置nginx，注意每個站點必須單獨占用一個server，同一server不同location定向到不同的應用不知為何總是失敗，估計也算是一個bug。

server {
        listen       80;
        server_name  app1.mydomain.com;
        location / {
                include uwsgi_params;
                uwsgi_pass 127.0.0.1:9090;
                uwsgi_param UWSGI_PYHOME /var/www/myenv;
                uwsgi_param UWSGI_SCRIPT myapp1;
                uwsgi_param UWSGI_CHDIR /var/www/myappdir1;
        }
    }
    server {
        listen       80;
        server_name  app2.mydomain.com;
        location / {
                include uwsgi_params;
                uwsgi_pass 127.0.0.1:9090;
                uwsgi_param UWSGI_PYHOME /var/www/myenv;
                uwsgi_param UWSGI_SCRIPT myapp2;
                uwsgi_param UWSGI_CHDIR /var/www/myappdir2;
        }
    }

這樣，重啟nginx服務，兩個站點就可以共用一個uwsgi服務了。

5.實戰應用

最初的設置完畢以后，再添加的應用，只需要在Nginx里面進行少量修改，無需重啟uwsgi，就能立刻部署完畢。uwsgi自帶了基於django的監控uwsgi運行狀態的工具，就拿它來部署好了：

server {
    listen 80;
    root   /var/www/django1.23;
    index  index.html index.htm;
    server_name uwsgiadmin.django.obmem.info;
    access_log  /var/log/nginx/django.access.log;
    location /media/ {
        root /var/www/django1.23/adminmedia;
        rewrite ^/media/(.*)$ /$1 break;
    }
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;
        uwsgi_param UWSGI_PYHOME /var/www/django1.23/vtenv;
        uwsgi_param UWSGI_CHDIR /var/www/django1.23/uwsgiadmin;
        uwsgi_param UWSGI_SCRIPT uwsgiadmin_wsgi;
    }
}

於是uwsgi的監控信息可以在http://uwsgiadmin.django.obmem.info看到（用戶名密碼都是admin）。再比如LBForum論壇程序的部署：根據安裝說明安裝完畢，再按部署說明修改完配置文件，然后只需修改nginx配置文件：

server {
    listen 80;
    root   /var/www/django1.23;
    index  index.html index.htm;
    server_name lbforum.django.obmem.info;
    access_log  /var/log/nginx/django.access.log;
    location / {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:9090;
        uwsgi_param UWSGI_PYHOME /var/www/django1.23/vtenv;
        uwsgi_param UWSGI_CHDIR /var/www/django1.23/LBForum/sites/default;
        uwsgi_param UWSGI_SCRIPT lbforum_wsgi;
    }
}

於是http://lbforum.django.obmem.info就是論壇程序了。

后記

雖然寫出來寥寥幾行，配置的時候我可吃盡了uwsgi的苦頭，有些想當然的用法完全不能成立，–no-site參數一加上去其他都好使LBForum怎么都部署不了，一開始多站點公用uwsgi怎么都成功不了等等。

Python世界很有趣，一直會發現有趣的東西，但是Python世界也很折騰人，大部分東西都是dev版本，文檔缺失，各種兼容問題。

原文地址：http://obmem.info/?p=703

uwsgi官網：http://projects.unbit.it/uwsgi/