这几天学着用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