Gunicorn-配置详解

一、为什么用gunicorn+gevent启动Flask项目

1、初识guincorn、gevent

Flask，webpy，Django都带着 WSGI server，当然性能都不好，自带的web server 更多的是测试用途。线上发布时，则使用高性能的wsgi server或者是联合nginx做uwsgi 。
greenlet是一个轻量级的协程库。gevent是基于greenlet的网络库。
guincorn是支持wsgi协议的http server，gevent只是它支持的模式之一 ，是为了解决django、flask这些web框架自带wsgi server性能低下的问题。它的特点是与各个web框架结合紧密，部署特别方便。

2、flask的缺点

单纯的flask 自带的web服务器做下测试，会看到压力大的时候出现socket的问题，因为他是单进程单线程的。使用gunicorn来启动，响应速度和能力提升显著。配置中workers指定启动的进程数。cpu的损耗是平均到各个进程。workers的值一定不要过大，毕竟多进程对于系统的调度消耗比较大。

二、ip加端口，绑定运行的主机方法启动

1、创建flask的应用程序

# server.py
from flask import Flask  
def create_app():  
    app = Flask(__name__)  
    return app  
app = create_app()   
@app.route('/')  
def index():  
    return 'hello world!' 
if __name__ == '__main__':  
    app.run()

2、gunicorn启动一个flask的应用程序

# 第一个app指的是app.py文件，第二个指的是flask应用的名字（在flask的项目的目录下启动）
gunicorn -w 4 -b 0.0.0.0:8000 server:app
#指定启动的进程数量
#gunicorn -w 4 -b 0.0.0.0:8000 server:app 
#Gunicorn可绑定多个套接字
#gunicorn -b 0.0.0.0:8000 -b [::1]:9000 server:app

三、通过配置文件启动

1、配置文件

# config.py
from gevent import monkey
monkey.patch_all()          # python 网络接口多进程处理包
import multiprocessing

debug = False
# 监听内网端口5000
bind = '127.0.0.1:5000'
# 监听队列
backlog=2048                
# 并行工作进程数
workers = 4
# 每个进程的开启线程
threads = 2

# workers = multiprocessing.cpu_count() * 2 + 1
# threads = multiprocessing.cpu_count() * 2

# 设置守护进程,将进程交给supervisor管理
daemon = 'false'
# 工作模式协程。使用gevent模式，还可以使用sync模式，默认的是sync模式
worker_class = 'gevent'
# #worker_connections最大客户端并发数量，默认情况下这个值为1000。此设置将影响gevent和eventlet工作模式
worker_connections = 2000
#超时
timeout=180

# # 进程pid记录文件
# pidfile = 'app_pid.log'
# loglevel = '/logs/debug'
# logfile = '/logs/gun_debug.log'
# accesslog = '/logs/gun_access.log'
# access_log_format = '%(h)s %(t)s %(U)s %(q)s'
# errorlog = '/logs/gun_error.log'

2、启动gunicorn

#server:app  server指的是server.py文件(配置flask接口的文件),app指的是flask应用的名字
nohup gunicorn -c  $(pwd)/config.py server:app  &> ./logs/uwsgi.log  &
#gunicorn -c gunicorn.conf server:app

三、gunicorn的参数详解

'''
-c CONFIG    : CONFIG,配置文件的路径，通过配置文件启动；生产环境使用；
-b ADDRESS   : ADDRESS，ip加端口，绑定运行的主机；
-w INT, --workers INT：用于处理工作进程的数量，为正整数，默认为1；
-k STRTING, --worker-class STRTING：要使用的工作模式，默认为sync异步，可以下载eventlet和gevent并指定
--threads INT：处理请求的工作线程数，使用指定数量的线程运行每个worker。为正整数，默认为1。
--worker-connections INT：最大客户端并发数量，默认情况下这个值为1000。
--backlog int：未决连接的最大数量，即等待服务的客户的数量。默认2048个，一般不修改；
-p FILE, --pid FILE：设置pid文件的文件名，如果不设置将不会创建pid文件

--access-logfile FILE   ：  要写入的访问日志目录
--access-logformat STRING：要写入的访问日志格式
--error-logfile FILE, --log-file FILE  ：  要写入错误日志的文件目录。
--log-level LEVEL   ：   错误日志输出等级。

--limit-request-line INT   ：  HTTP请求头的行数的最大大小，此参数用于限制HTTP请求行的允许大小，默认情况下，这个值为4094。值是0~8190的数字。
--limit-request-fields INT   ：  限制HTTP请求中请求头字段的数量。此字段用于限制请求头字段的数量以防止DDOS攻击，默认情况下，这个值为100，这个值不能超过32768
--limit-request-field-size INT  ：  限制HTTP请求中请求头的大小，默认情况下这个值为8190字节。值是一个整数或者0，当该值为0时，表示将对请求头大小不做限制

-t INT, --timeout INT：超过这么多秒后工作将被杀掉，并重新启动。一般设定为30秒；
--daemon： 是否以守护进程启动，默认false；
--chdir： 在加载应用程序之前切换目录；
--graceful-timeout INT：默认情况下，这个值为30，在超时(从接收到重启信号开始)之后仍然活着的工作将被强行杀死；一般使用默认；
--keep-alive INT：在keep-alive连接上等待请求的秒数，默认情况下值为2。一般设定在1~5秒之间。
--reload：默认为False。此设置用于开发，每当应用程序发生更改时，都会导致工作重新启动。
--spew：打印服务器执行过的每一条语句，默认False。此选择为原子性的，即要么全部打印，要么全部不打印；
--check-config   ：显示现在的配置，默认值为False，即显示。
-e ENV, --env ENV： 设置环境变量
'''

参考文献：
1、https://www.cnblogs.com/cwp-bg/p/8780204.html
2、https://blog.csdn.net/myli_binbin/article/details/90640531
3、https://www.cnblogs.com/fengff/p/9225859.html