最近使用uwsgi 部署了flask应用,出现了不少问题,仔细查阅了一下资料以及翻看了官方文档,就对自己了解到的做个总结~~
一、http/http-socket/socket
uwsgi开头当然少不了通信的接口。
有3种方式:
socket=127.0.0.1:8888
http=0.0.0.0:8888
http-socket=127.0.0.1:8888
三个方式看起来十分的相似,阅读了很多博客和官方文档,下面是自己的一些理解(可能不完全正确)!
图一是socket方式,现在大部分web服务器(如nginx)支持uwsgi, 这是这三种方式最高效的一种形式,socket通信速度会比http快
图二是http-socket方式,这个适用于web服务器不支持uwsgi时。
后面2个图都是http方式,使用http启动uwsgi,系统会额外启动一个http进程,从级别上来说,它和nginx是同一级别的,所以客户端和uwsgi通信,完全可以绕过nginx,不需要额外进行一个转发(如图三一样),但很显然,这是并不是一个很明智但选择,这样会失去了nginx很多优秀的功能。
官方推荐的方式为socket以及http-socket方式,显然使用http方式会额外产生一个http进程,如果还通过nginx转发,那么效率上来说是相对比较低的。
二、processes/workers.
表示开启多进程,根据你的应有开启合适的进程数,在一些参考资料上,可能会看到processes = 2 * cpucores或者workers = 2 * cpucores,如果应有比较简单,这样设置一般可以。如果想更合理,官方提供了uwsgitop去获得一个较为合理的值。
三、threads & enable-threads
python中存在GIL,实际上不存在真正意义上的多线程,但是否需要,这个就根据各自但需求设定了。结合processes:
processes=2
threads=4
表示2个进程,每个进程中有4个线程。
由于GIL的存在,uwsgi索性默认不支持多线程,不对GIL进行初始化。但如果希望程序中的线程发挥作用,需要加入enable-threads=True;
但如果已经在多线程模式(使用 threads 选项)下,那么uWSGI将会自动启用线程支持。
四、uid & gid & chmod-socket
uwsgi不建议使用root权限去启动uwsgi实例。可以通过root用户去运行uwsgi文件,当通过uid和gid去修改用户(移除root权限)。并且,如果你使用的是socket的通信方式,最好加上chmod-socket字段,在linux下,socket的启动方式,套接字类似文件,你必须保证有权限去读取它。
chmod-socket=660
uid=1000
gid=1000
五、master
意味着启动一个master主进程来管理其他进程,建议启动这个进程,在管理的时候比较方便;如果kill这个master进程,相当于关闭所有的uwsgi进程。
六、其他
chdir: 工程目录(启动文件所在位置)。
module: 应有程序文件(这个字段与wsgi-file相似?)
callable:flask应用实例的名称,是flask独有的配置项(django不需要)。由于flask存在特殊的机制,可以实例化多个application,需要明确指出,收到请求时,uwsgi应该调用哪个应用实例。
buffer-size: 设置用于uwsgi包解析的内部缓存区大小,默认是4k。如果你允许接受较大数据的报头,这个值可以设置到64k,如果出现报头过大的错误,可以通过设置这个值解决。
daemonize: 日志输出文件。
disable-logging: 不记录正常的请求日志,只记录错误日志。
七、lazy-app
这个字段有着特殊的作用,目前还在测试与使用,接下来再把发现的问题更新进来。
下面是是我flask项目的完整uwsgi文件:
socket=127.0.0.1:9088
#http-socket=127.0.0.1:8888
#http=127.0.0.1:8888
processes=2
threads=4
enable-threads=true
lazy-apps=true
uid=1000
gid=1000
chmod-socket=660
master=true
chdir=/data/myapp/
module=manage
callable=app
buffer-size=65536
daemonize=/data/log/uwsgi/app.log