配置Nginx＋uwsgi更方便地部署python应用

文章来源：http://blogread.cn/it/article.php?id=2482&f=hot7

个人觉得php最方便的就是deployment了，只要把php文件丢到支持php的路径里面，然后访问那个路径就能使用了；无论给主机添加多少php应用，只要把目录改好就没你的事了，完全不用关心php-cgi运行得如何，deployment极为方便。

反观python，部属起来真是头痛，常见的部署方法有：

1. fcgi：用spawn-fcgi或者框架自带的工具对各个project分别生成监听进程，然后和http服务互动
2. wsgi：利用http服务的mod_wsgi模块来跑各个project

无论哪种都很麻烦，apache的mod_wsgi配置起来很麻烦，内存占用还大，如果要加上nginx作为静态页面的服务器那就更麻烦了；反正我 的应用基本上到后来都是是各个project各自为战，且不说管理上的混乱，这样对负载也是不利的，空闲的project和繁忙的project同样需要 占用内存，很容易出现站着茅坑不拉屎的现象。

如果有个啥东东能像php-cgi一样监听同一端口，进行统一管理和负载平衡，那真是能省下大量的部署功夫。偶然看到了，才发现居然一直不知道有那么方便地统一部署工具。

uWSGI，既不用wsgi协议也不用fcgi协议，而是自创了一个uwsgi的协议，据说，有个比较见下图

uWSGI的主要特点如下，其中一些功能让我感动得泪流满面

1. 超快的性能
2. 低内存占用（实测为apache2的mod_wsgi的一半左右）
3. 多app管理（终于不用冥思苦想下个app用哪个端口比较好了-.-）
4. 详尽的日志功能（可以用来分析app性能和瓶颈）
5. 高度可定制（内存大小限制，服务一定次数后重启等）

总而言之uwgi是个部署用的好东东，正如uWSGI作者所吹嘘的：

If you are searching for a simple wsgi-only server, uWSGI is not for you, but if you are building a real (production-ready) app that need to be rock-solid, fast and easy to distribute/optimize for various load-average, you will pathetically and morbidly fall in love (we hope) with uWSGI.

正式开工

uwsgi的文档虽然蛮多也很详细，但是他们网站的排版真是让人无语，粗粗看上去根本不知道文档在哪里。其实是在这里：

0.安装uwsgi

ubuntu有uwsgi的ppa

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

1. 用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()) application = app.wsgifunc()

再比如django就是

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

然后运行uwsgi监听9090，其中-w后跟模块名，也就是刚才配置的myapp

uwsgi -s :9090 -w myapp

运行网站发现已经部署完成了。

2. 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

更多用法见文档：

3.为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服务了。

4.实战应用

最初的设置完毕以后，再添加的应用，只需要在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的监控信息可以在 看到用户名密码都是admin。

再比如论坛程序的部署：根据安装完毕，再按修改完配置文件，然后只需修改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; } }

于是 就是论坛程序了。

后记

虽然写出来寥寥几行，配置的时候我可吃尽了uwsgi的苦头，有些想当然的用法完全不能成立，-no-site参数一加上去其他都好使LBForum怎么都部署不了，一开始多站点公用uwsgi怎么都成功不了等等。

python世界很有趣，一直会发现好玩的东东，但是python世界也很折腾人，大部分东东都是dev版本，文档缺失，各种兼容问题……大约是因为在python中，有个idea到实现出来实在是太过高效的关系吧，唉，被折腾死了。