Flask + WSGI + Nginx 云部署

这几天学着用flask写一些rest api，然后部署到云上。这个过程虽然网上有很多的教程，但还是遇到不少的问题！

采用flask的原因是因为它比较容易上手吧。用flask有专门restful api的框架，用起来简单粗暴有木有！另外，

查了一下flask的应用框架，发现用WSGI + Nginx有下面的几个优势：

• 高性能
• 部署比较方便，采用Nginx可以部署多个Flask的应用

在此非常感谢Ray在他的blog中提到了在阿里云上部署Flask应用。他的这篇bolg给了我很大启示(我的项目中的

目录都是按照他的做法)，给出他的这篇blog的地址：
　　http://www.cnblogs.com/Ray-liang/p/4173923.html

我的python环境和python开发环境都是和ray的这篇blog提到的一样的，Ray已经写得足够好啦！

我写一点不一样的东西，我假设你的Flask的应用已经完成，现在只是部署的问题。我的项目整体的目录如下：

---/home/www/my_flask
                     | --- app
                           | --- __init__.py // 包文件
                           | --- ......      // 其他目录或文件　　
                     | --- config.ini        // uwsgi文件
                     | --- requiremwnt.txt   // 项目所需的pip安装包
                     | --- manage.py         // Flask Script,用于启动Flask应用
                     | --- logs              // Flask应用部署时的产生的log文件保存路径
                     | --- venv              // 虚拟环境
                           | --- bin
                           | --- local
                           | --- lib
                           | --- pip-selfcheck.json

其中config.ini为部署uwsgi新建的文件，magnage.py为启动Flask应用所新建的文件。

安装uwsgi:

 (venv) my_flask root@iZ25i0x7zadZ : pip install uwsgi

 配置uwsgi:

[uwsgi]

# uwsgi 启动时所使用的地址与端口

http-socket = 127.0.0.1:5000

# 指向网站目录

chdir = /home/www/my_flask

# python 启动程序文件

wsgi-file = manage.py

# python 程序内用以启动的 application 变量名

callable = app

# 处理器数

processes = 4

# 线程数

threads = 2

#状态检测地址

stats = 127.0.0.1:919

由于在部署的时候，应用是rest api,采用socket的方式进行通信会存在缓存不足的情况,如果访问url,

则会出现下面的情况：

*** Stats server enabled on 127.0.0.1:919 fd: 15 ***
invalid request block size: 21573 (max 4096)...skip

此时，你应该修改你的config.ini的配置，将socket修改为http-socket.这样问题就解决了。另外还有一篇

blog对这个讲得很详细：

https://emptyhammock.com/projects/info/pyweb/simple.html

uwsgi配置完成后，验证配置是否正确

$ uwsgi config.ini

接下来安装supervisor,

supervisor的安装

my_flask root@iZ25i0x7zadZ : sudo apt-get install supervisor

配置supervisor

在/etc/supervisor/conf.d/目录下新建my_flask.conf文件，具体配置如下：

[program:my_flask]
# 启动命令入口
command=uwsgi /home/www/my_flask/config.ini

# 命令程序所在目录
directory=/home/www/my_flask
#运行命令的用户名
user=root

autostart=true
autorestart=true
#日志地址
stdout_logfile=/home/www/my_flask/logs/uwsgi_supervisor.log

这里的command和ray的有所不同, 具体原因我现在还不太明白。但可以确定的是，在/home/www/my_flask目录

下运行uwsgi config.ini可以启动flask 应用。此外经过测试，只要命令程序所在目录正确，command的取值只需写

命令，而不需要将目录写全。

当配置好supervisor后就可以启动supervisor进行本地测试。

最后为Nginx的安装与配置：

Nginx的安装

sudo apt-get install nginx

Nginx的配置

server {
         listen  8080;
          server_name XXX.XX.XXX.XXX; #公网地址

          location / {
                include      uwsgi_params;
                proxy_pass   http://127.0.0.1:5000;
                uwsgi_param UWSGI_PYHOME /home/www/my_flask/venv; # 指向虚拟环境目录
                uwsgi_param UWSGI_CHDIR  /home/www/my_flask; # 指向网站根目录
                uwsgi_param UWSGI_SCRIPT manage; # 指定启动程序
          }
}

这其中和ray的另外一个不同在于proxy_pass，由于之前在配置uwsgi的时候选择了http-scoket的

方式，这样在设置代理的时候应该是proxy_pass而不是uwsgi_pass.在stackoverflow的一篇问答

中查到，貌似uwsgi不支持http的反向代理。至于其他的步骤则完全参照ray的博客。

【参考资料】

[1] http://www.cnblogs.com/Ray-liang/p/4173923.html

[2] https://emptyhammock.com/projects/info/pyweb/simple.html

[3] http://maximebf.com/blog/2012/10/building-websites-in-python-with-flask/#.VbsPGBOqqkq

[4] http://flask-cn.readthedocs.org/en/latest/patterns/packages/#id2