Flask+uWSGI+Nginx部署过程

版权声明：转载时请以超链接形式标明文章原始出处和作者信息及本声明
http://blackgu.blogbus.com/logs/171363164.html

这两天一直在纠结地部署Flask+uWSGI+Nginx，也许是因为我领悟能力有问题，这个部署过程研究了整整一天，看了很多文档，其他开发人员写的部署的博客，但是发现都写得不够好，有些细节没提及，导致走了些弯路，所以我写了这篇blog，给后面在部署Flask+uWSGI+Nginx的同学一些帮助。

首先，我用的Flask是0.8版本的，uwsgi是0.9.9.2版，nginx是1.0版本，这个版本很重要，因为uwsgi的0.9.8版和0.9.9.2版在command line上有些option是不同的，具体可以安装完uwsgi，在terminal里敲"wsgi -h"的帮助里看命令的option信息；nginx1.0版和nginx0.8版也有差别，nginx1.0里采用了和apache相似的sites-available和sites-enable来实现配置的virtual host组件化，而nginx0.8版里还是老风格，因为在我查资料时经常碰到别人的配置部署就OK，但在我的环境下就不行，其实一部分原因是和环境有关。操作系统我用的是ubuntu11.10

1）安装Flask，uwsgi，nginx

Flask：sudo apt-get install python-flask

uwsgi：可以看下http://library.linode.com/web-servers/nginx/python-uwsgi/ubuntu-10.10-maverick

nginx：sudo apt-get install nginx

2）创建Flask工程

这里就用最简单的HelloWorld，创建一个工程目录：myapp，里面包含以下文件：

文件名：myapp.py

代码：

from flask import Flask

app = Flask(__name__)

 

@app.route('/')

def hello():

     return 'Hello World'

 

if __name__ == '__main__':

       app.run()

 

3）配置uwsgi

在刚才创建的myapp目录下创建一个uwsgi的xml配置文件myapp_config.xml:

<uwsgi>

     <pythonpath>[你的工程的根目录]</pythonpath>

     <module>[模块名，这里用myapp]</module>

     <callable>[因为app是启动整个服务的入口，所以是app]</callable>

     <socket>/tmp/uwsgi.sock</socket>       #注：这里的sock文件不是某个现成的文件，也不需要事先创建，运行时会自动创建，文件名也是自己定的，路径也是可以自己定的

     <master/>

     <processes>4</processes>                #注：跑几个线程，这里用4个线程

     <memory-report/>

</uwsgi>

样例：

<uwsgi>

     <pythonpath>/root/workspace_aptana/mytest/src/test/uwsgi</pythonpath>

     <module>myapp</module>

     <callable>app</callable>

     <socket>/tmp/uwsgi.sock</socket>

     <master/>

     <processes>4</processes>

     <memory-report/>

</uwsgi>

3）配置nginx

在/etc/nginx/sites-available/目录下，创建一个站点文件：site

server {
        listen 80;
        server_name www.myapp.com;

        location / {
                include uwsgi_params;
                uwsgi_pass unix:/tmp/uwsgi.sock;   #注：这里的sock文件和uwsgi的sock文件配的是同一个文件，因为nginx和uwsgi需要通过这个socket进行交互
        }
}

直接在defaut.conf里面修改后如下：

server {
        listen 8081;
        server_name localhost;

        location / {
                include uwsgi_params;
                uwsgi_pass unix:/tmp/uwsgi.sock;  
        }
}

然后用Linux的ln命令创建一个link到/etc/nginx/sites-enable/里，link的名字也叫site，删除sites-enable目录下的default的link

:    ln -s /etc/nginx/sites-available/hello.conf /etc/nginx/sites-enabled/

4）开始部署

1.启动uwsgi，命令是sudo uwsgi -x myapp_config.xml，会打出很多的字，如果没有加载工程成功可以从打出的信息中看出，然后不要关闭该Terminal，

2.新打开一个Terminal，在里面启动nginx：sudo /etc/init.d/nginx start，然后在浏览器里访问localhost（看配置的nginx里的server监听的端口，如上面的8），

3这时如果出现502页面，可以看下日志，我的日志是在/var/log/nginx/error.log，如果里面显示是sock文件因为权限问题无法访问，那只要利用chmod命令给sock文件赋上权限：chmod 777 /tmp/uwsgi.sock，然后uwsgi和nginx再重启一下，现在访问localhost就可以看到“Hello World！”，OK！