学习VirtualEnv和Nginx+uwsgi用于django项目部署

以下叙述中用到的操作系统：Linux CentOS 6.X。

最近几天了解一下VirtualEnv，Apache+Daemon mode，Nginx+uwsgi的概念，并且在项目中实验性部署了一下（目前我们的Django项目都使用Apache+mod_wsgi部署的，听说使用Nginx+uwsgi效率更高一些）。以下都是事后记录的安装部署过程，可能存在遗忘细节的地方。

1. VirtualEnv

VirtualEnv的作用：创建隔离的Python环境，解决模块或库的版本冲突或依赖。

在实际开发过程中，不同项目可能使用不同版本的库，例如，我们使用的Web框架Django，老项目使用的老的版本1.2.3,新项目使用的是1.4或1.5版本。那时我使用了最笨办法，即修改Django目录以切换，幸好没有使用太多多版本库，不然累死。

• • 安装步骤（网上能找到很多安装VirtualEnv的URL，参考http://www.cnblogs.com/kym/archive/2011/12/29/2306428.html）：
    • easy_install virtualenv #安装
    • virtualenv <myvenv>  #创建虚拟环境
    • 切换到虚拟环境<myvenv>目录运行source ./bin/activate #激活虚拟环境
    • 可以在虚拟环境安装使用包，例如安装Django：easy_install Django
    • 离开虚拟环境，使用命令：deactivate
  • 应用虚拟环境

　　　目前我们使用Apache+mod_wsgi部署Django项目的，项目可以通过以下方式使用虚拟环境：

　　　　　　WSGI作为Apache子进程运行

　　　　　　在httpd.conf中，可以VirtualHost上一行添加：WSGIPythonPath <myvenv path>/lib/python2.7/site-packages/.

        　　　  WSGI作为独立daemon进程运行（参考http://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIDaemonProcess.html）

　　　　　　在WSGIDaemonProcess指令后添加：python-path=<myvenv path>/lib/python2.7/site-packages。

　　　　　　BTW：这种方式部署的时候，需要在httpd.conf中添加WSGISocketPrefix <full path>,否则web请求可能会503失败 （参考http://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGISocketPrefix.html）

1. nginx && uwsgi

　　nginx可以作为WEB Server，反向代理，负载均衡等服务。

　　

• • 安装参考

　　　　　　nginx：http://wiki.nginx.org/Install，我选择的源码安装，安装后没有自启动的服务（网上有方法为nginx创建服务）

　　　　　　uwsgi：http://uwsgi-docs.readthedocs.org/en/latest/WSGIquickstart.html#installing-uwsgi-with-python-support

• • 为Django项目的配置

uwsgi的配置<project path>/uwsgi_XXX.ini如下(使用的是unix socke file方式进程通讯，在nginx也需要配相同路径文件)。注：如果要使用VirtualEnv虚拟环境，请设置home为虚拟环境路径。

# uwsgi_XXX.ini file
[uwsgi]

# Django-related settings
# the base directory (full path)
chdir           = /var/www/<project path>
# Django's wsgi file
module          = <project name>.wsgi
# the virtualenv (full path)
home            = <virtualenv path>

uid=apache
gid=apache

# process-related settings
# master
master          = true
# maximum number of worker processes
processes       = 10
# the socket (use the full path to be safe
socket          = /var/www/<project path>/<project name>.sock
# ... with appropriate permissions - may be needed
# chmod-socket    = 664
# clear environment on exit
vacuum          = true

daemonize = /var/log/uwsgi.log
stats = 0.0.0.0:9191

pidfile=/var/www/<project path>/uwsgi.pid

另外需要在<project path>/<project name>/目录下创建文件wsgi.py。注：请记住添加PYTHON_EGG_CACHE,不然会报权限错误。

import os
os.environ['PYTHON_EGG_CACHE'] = '/<a path>/.python-eggs/' #为了防止Permission denied的web请求访问错误。
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "maps.settings")

# This application object is used by any WSGI server configured to use this
# file. This includes Django's development server, if the WSGI_APPLICATION
# setting points here.
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

操作uwsgi进程(切换到<project path>目录下):

• 启动：uwsgi --ini uwsgi_XXX.ini
• 停止：uwsgi --stop uwsgi.pid
• reload: uwsgi --reload uwsgi.pid

#------------------------------------------------------------------------------------

nginx的配置如下（由于uwsgi配置使用unix socket file进程通讯的）

user  apache; # 指定用户
worker_processes  2;#启动2进程

pid        logs/nginx.pid; #指定pid文件


events {
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;
    keepalive_timeout  65;

    #gzip  on;
    upstream django {
    server unix:///var/www/<项目path>/XXX.sock; # for a file socket
    #server 127.0.0.1:8001; # for a web port socket (we'll use this first)
    }

    server {
        listen       8050;# listen port
        server_name  localhost;

        charset utf-8;

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
location /media  {
        alias /var/www/<项目path>/media;
    }
location / {
        uwsgi_pass  django;
        include     uwsgi_params; # the uwsgi_params file you installed
    }

操作nginx进程：

• 启动：/usr/local/nginx/sbin/nginx
• 停止：/usr/local/nginx/sbin/nginx -s stop

That's all.