Gunicorn是一个unix上被广泛使用的高性能的Python WSGI UNIX HTTP Server。
和大多数的web框架兼容，并具有实现简单，轻量级，高性能等特点。
gunicorn 安装
pip install gunicorn
gunicorn + flask 简单示例
flask程序需要先安装flask module，pip install flask。
gunicorn_demo.py
from flask import Flask app = Flask(__name__) @app.route('/demo', methods=['GET']) def demo(): return "gunicorn and flask demo."
通过gunicorn运行flask app
# gunicorn gunicorn_demo:app [2017-12-23 10:36:09 +0000] [24441] [INFO] Starting gunicorn 19.7.1 [2017-12-23 10:36:09 +0000] [24441] [INFO] Listening at: http://127.0.0.1:8000 (24441) [2017-12-23 10:36:09 +0000] [24441] [INFO] Using worker: sync [2017-12-23 10:36:09 +0000] [24446] [INFO] Booting worker with pid: 24446
测试结果
# curl http://127.0.0.1:8000/demo gunicorn and flask demo.
gunicorn 详细配置
gunicorn配置项可以通过gunicorn的启动命令行中设定，也可以通过配置文件指定。强烈建议使用一个配置文件。
配置项如下：
server socket
-
bind
监听地址和端口。 -
backlog
服务器中在pending状态的最大连接数，即client处于waiting的数目。超过这个数目， client连接会得到一个error。
建议值64-2048。
worker 进程
-
workers
worker进程的数量。建议值2-4 x $(NUM_CORES)， 缺省为1。 -
worker_class
worker进程的工作方式。 有 sync, eventlet, gevent, tornado, gthread, 缺省值sync。 -
threads
工作进程中线程的数量。建议值2-4 x $(NUM_CORES)， 缺省值1。
此配置只适用于gthread 进程工作方式， 因为gevent这种使用的是协程工作方式。 -
worker_connections
客户端最大同时连接数。只适用于eventlet， gevent工作方式。 -
max_requests
worker重启之前处理的最大requests数， 缺省值为0表示自动重启disabled。主要是防止内存泄露。 -
max_requests_jitter
抖动参数，防止worker全部同时重启。 -
timeout
通常设为30。 -
graceful_timeout
接收到restart信号后，worker可以在graceful_timeout时间内，继续处理完当前requests。 -
keepalive
server端保持连接时间。
security
-
limit_request_line
http request line最大字节数。值范围0-8190， 0表示无限制。 -
limit_request_field
http request中 header字段数的最大值。缺省为100，最大32768。 -
limit_request_field_size
http request header字段最大字节数。0表示无限制。
调试
-
reload
当代码有修改时，自动重启workers。适用于开发环境。 -
reload_extra_files
扩展reload配置，增加templates，configurations等文件修改监控。 -
spew
跟踪程序执行的每一行。 -
check_config
检查配置。
server 机制
-
sendfile
系统底层拷贝数据方式，提供performance。 -
chdir
在app加载之前，进入到此目录。 -
daemon
应用是否以daemon方式运行。 -
raw_env
key=value, 传递环境参数。 -
pidfile
pid存储文件路径。 -
worker_tmp_dir
临时工作目录。 -
user
指定worker进程的运行用户名。 -
group
指定worker进程运行用户所在组。 -
umask
gunicorn创建文件的缺省权限。 -
pythonpath
附加到python path的目录列表。
日志
-
accesslog
访问日志文件路径。 -
access_log_format
日志格式。 例如 %(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s" 。 -
errorlog
错误日志路径。 -
loglever
日志级别。debug, info, warning, error, critical. -
capture_output
重定向stdout/stderr到error log file。 -
logger_class
日志实现类。缺省gunicorn.glogging.Logger 。 -
logconfig
日志配置文件。同python标准日志模块logging的配置。
进程名
- proc_name
设置进程名(setproctitle)，在ps，top等命令中会看到. 缺省值为default_proc_name配置。
server钩子
- on_starting
- on_reload
- when_ready
- pre_fork
- post_fork
- post_worker_init
- worker_init
- worker_abort
- pre_exec
- pre_request
- post_request
- child_exit
- worker-exit
- nworkers_changed
- on_exit
Gunicorn配置
Gunicorn从三个不同的地方读取配置信息。
第一个地方:从framework定义的配置信息中读取,目前只对 Paster 框架有效。
第二个地方:在命令行中定义,命令行中定义的配置信息将会覆盖掉框架中定义的相同的参数名的值。
最后:将所有的参数信息,放到一个文件中,只要是在命令行中可以定义的参数中,在配置文件中都可以定义。(是一个Python源文件,所以你就像在写Python代码一样)
第一个地方不不介绍了,不实用。重点介绍第二种和第三种,其实这两种方式都是相同的。
显示说有配置选项:
gunicorn -h
使用命令行配置:
在上面的 myapp 例子的基础上
gunicorn --workers=4 --bind=127.0.0.1:8000 myapp.test:app
上面的命令 启动 4个 workers ,绑定到 127.0.0.1：8000
配置文件 config.py 源码
import multiprocessing bind = "127.0.0.1:8001" workers = multiprocessing.cpu_count() * 2 + 1
使用配置文件启动Gunicorn
gunicorn --config=config.py myapp.test:app
和上面用命令行配置的效果完全一样，当然两者还可以结合起来用:
gunicorn --config=gunicorn_conf.py --worker-class=eventlet myapp.test:app
worker-class默认是sync(同步),我们配置成了 eventlet(并发的)