快速部署Python应用：Nginx+uWSGI配置详解

o2geao

相比于PHP，Python应用的部署很麻烦，比较常用的方法有fcgi与 wsgi，然而这两种都很让人头痛。文章介绍了Nginx＋uwsgi的简便方法，来快速的部署Python应用。

　　在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倍那么快，有个比较见下图：

http://hiphotos.baidu.com/hysia/pic/item/870d9051b4b2f350377abe6e.jpg

　　uWSGI的主要特点如下：
　　◆超快的性能。
　　◆低内存占用（实测为apache2的mod_wsgi的一半左右）。
　　◆多app管理。
　　◆详尽的日志功能（可以用来分析app性能和瓶颈）。
　　◆高度可定制（内存大小限制，服务一定次数后重启等）。
　　正式开工
　　uwsgi的文档虽然很多也很详细，这里是uwsgi的官方文档：http://projects.unbit.it/uwsgi/wiki/Doc。
　　1.安装uwsgi
　　ubuntu有uwsgi的ppa：

• add-apt-repositoryppa:stevecrozz/ppa
  
• apt-getupdate
  
• apt-getinstalluwsgi
  

　　2. 用uwsgi代替mod_wsgi
　　Nginx的整体配置说来话长，这里不再多说，假设已经明白 Nginx的基本配置，那么uwsgi就类似这么配置：

• location/{
  
• includeuwsgi_params
  
• uwsgi_pass127.0.0.1:9090
  
• }
  

　　这就是把所有url传给9090端口的uwsgi协议程序来互动。再到project目录建立myapp.py，使得application调用框 架的wsgi接口，比如web.py就是：

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

　　再比如django就是：

• .......
  
• fromdjango.core.handlers.wsgiimportWSGIHandler
  
• 
  application=WSGIHandler()
  

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

• uwsgi-s:9090-wmyapp
  

　　运行网站发现已经部署完成了。
　　3.uwsgi的参数
　　以上是单个project的最简单化部署，uwsgi还是有很多令人称赞的功能的，例如：
　　并发4个线程：

• uwsgi-s:9090-wmyapp-p4
  

　　主控制线程+4个线程：

• uwsgi-s:9090-wmyapp-M-p4
  

　　执行超过30秒的client直接放弃：

• uwsgi-s:9090-wmyapp-M-p4-t30
  

　　限制内存空间128M：

• uwsgi-s:9090-wmyapp-M-p4-t30--limit-as128
  

　　服务超过10000个req自动respawn：

• uwsgi-s:9090-wmyapp-M-p4-t30--limit-as128-R10000
  

　　后台运行等：

• uwsgi-s:9090-wmyapp-M-p4-t30--limit-as128-R10000-duwsgi.log
  

　　4.为uwsgi配置多个站点
　　为了让多个站点共享一个uwsgi服务，必须把uwsgi运行成虚拟站点：去掉“-w myapp”加上”–vhost”：

• uwsgi-s:9090-M-p4-t30--limit-as128-R10000-duwsgi.log--vhost
  

　　然后必须配置virtualenv，virtualenv是Python的一个很有用的虚拟环境工具，这样安装：

• apt-getinstallPython-setuptools
  
• easy_installvirtualenv
  

　　然后设置一个/多个app基准环境：

• virtualenv/var/www/myenv
  

　　应用环境，在此环境下安装的软件仅在此环境下有效：

• source/var/www/myenv/bin/activate
  
• pipinstalldjango
  
• pipinstallmako
  
• ...
  

　　最后配置nginx，注意每个站点必须单独占用一个server，同一server不同location定向到不同的应用不知为何总是失败，估计也 算是一个bug。

• server{
  
• listen80;
  
• server_nameapp1.mydomain.com;
  
• location/{
  
• includeuwsgi_params;
  
• uwsgi_pass127.0.0.1:9090;
  
• uwsgi_paramUWSGI_PYHOME/var/www/myenv;
  
• uwsgi_paramUWSGI_SCRIPTmyapp1;
  
• uwsgi_paramUWSGI_CHDIR/var/www/myappdir1;
  
• }
  
• }
  
• server{
  
• listen80;
  
• server_nameapp2.mydomain.com;
  
• location/{
  
• includeuwsgi_params;
  
• uwsgi_pass127.0.0.1:9090;
  
• uwsgi_paramUWSGI_PYHOME/var/www/myenv;
  
• uwsgi_paramUWSGI_SCRIPTmyapp2;
  
• uwsgi_paramUWSGI_CHDIR/var/www/myappdir2;
  
• }
  
• }
  

　　这样，重启nginx服务，两个站点就可以共用一个uwsgi服务了。
　　5.实战应用
　　最初的设置完毕以后，再添加的应用，只需要在Nginx里面进行少量修改，无需重启uwsgi，就能立刻部署完毕。uwsgi自带了基于 django的监控uwsgi运行状态的工具，就拿它来部署好了：

• server{
  
• listen80;
  
• root/var/www/django1.23;
  
• indexindex.htmlindex.htm;
  
• server_nameuwsgiadmin.django.obmem.info;
  
• access_log/var/log/nginx/django.access.log;
  
• location/media/{
  
• root/var/www/django1.23/adminmedia;
  
• rewrite^/media/(.*)$/$1break;
  
• }
  
• location/{
  
• includeuwsgi_params;
  
• uwsgi_pass127.0.0.1:9090;
  
• uwsgi_paramUWSGI_PYHOME/var/www/django1.23/vtenv;
  
• uwsgi_paramUWSGI_CHDIR/var/www/django1.23/uwsgiadmin;
  
• uwsgi_paramUWSGI_SCRIPTuwsgiadmin_wsgi;
  
• }
  
• }
  

　　于是uwsgi的监控信息可以在http://uwsgiadmin.django.obmem.info看 到（用户名密码都是admin）。再比如LBForum论坛程序的部署：根据安装说明安装完毕，再按部署说明修改完配置文件，然后只需修改nginx配置 文件：

• server{
  
• listen80;
  
• root/var/www/django1.23;
  
• indexindex.htmlindex.htm;
  
• server_namelbforum.django.obmem.info;
  
• access_log/var/log/nginx/django.access.log;
  
• location/{
  
• includeuwsgi_params;
  
• uwsgi_pass127.0.0.1:9090;
  
• uwsgi_paramUWSGI_PYHOME/var/www/django1.23/vtenv;
  
• uwsgi_paramUWSGI_CHDIR/var/www/django1.23/LBForum/sites/default;
  
• uwsgi_paramUWSGI_SCRIPTlbforum_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/