Gunicorn使用详解

Gunicorn使⽤详解
1.什么是Gunicorn
Gunicorn是⼀个WSGI HTTP服务器,python⾃带的有个web服务器，叫做wsgiref，
Gunicorn的优势在于，它使⽤了pre-fork worker模式，gunicorn在启动时，会在主进程中预先fork出指定数量的worker进程来处理请求，gunicorn依靠操作系统来提供负载均衡，推进的worker数量是(2*$num_cores)+1
我们知道，python是单线程的语⾔，当进程阻塞时，后续请求将排队处理。

所⽤pre-fork worker模式，极⼤提升了服务器请求负载。

2.gunicorn安装
apt-get install gunicorn
3.编写wsgi接⼝,test.py代码如下
def application(environ,start_response):
start_response('200 OK',[('Content-Type','text/html')])
return b'<h1>Hello,web!</h1>'
4.使⽤gunicorn监听请求，运⾏以下命令
gunicorn -w 2 -b 0.0.0.0:8000 test.application
运⾏结果：
-w:指定fork的worker进程数
-b:指定绑定的端⼝
test:模块名,python⽂件名
application:变量名,python⽂件中可调⽤的wsgi接⼝名称
5.访问web服务器
和使⽤wsgiref，访问wsgi接⼝⼀致
6.gunicorn相关参数
1)-c CONFIG,--config=CONFIG
指定⼀个配置⽂件（py⽂件）
2)-b BIND,--bind=BIND
与指定socket进⾏板顶
3)-D,--daemon
后台进程⽅式运⾏gunicorn进程
4)-w WORKERS,--workers=WORKERS
⼯作进程的数量
5)-k WORKERCLASS,--worker-class=WORKERCLASS
⼯作进程类型，包括sync（默认）,eventlet,gevent,tornado,gthread,gaiohttp
6)--backlog INT
最⼤挂起的连接数
7)--log-level LEVEL
⽇志输出等级
8)--access-logfile FILE
访问⽇志输出⽂件
9)--error-logfile FILE
错误⽇志输出⽂件
7.gunicorn参数配置⽂件
-c CONFIG,--config=CONFIG 指定⼀个配置⽂件（py⽂件）
gunicorn可以写在配置⽂件中，下⾯举列说明配置⽂件的写法,gunicorn.conf.py
bind = "0.0.0.0:8000"
workers = 2
运⾏以下命令:
gunicorn -c gunicorn.conf.py test:application
运⾏结果和使⽤命令⾏参数，结果⼀样。

gunicorn配置⽂件是⼀个python⽂件，因此可以实现更复杂的逻辑，如下：
# gunicorn.conf.py
import logging
import logging.handlers
from logging.handlers import WatchedFileHandler
import os
import multiprocessing
bind = '127.0.0.1:8000' #绑定ip和端⼝号
backlog = 512 #监听队列
chdir = '/home/test/server/bin' #gunicorn要切换到的⽬的⼯作⽬录
timeout = 30 #超时
worker_class = 'gevent' #使⽤gevent模式，还可以使⽤sync 模式，默认的是sync模式
workers = multiprocessing.cpu_count() * 2 + 1 #进程数
threads = 2 #指定每个进程开启的线程数
loglevel = 'info' #⽇志级别，这个⽇志级别指的是错误⽇志的级别，⽽访问⽇志的级别⽆法设置
access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"' #设置gunicorn访问⽇志格式，错误⽇志⽆法设置"""
其每个选项的含义如下：
h remote address
l '-'
u currently '-', may be user name in future releases
t date of the request
r status line (e.g. ``GET / HTTP/1.1``)
s status
b response length or '-'
f referer
a user agent
T request time in seconds
D request time in microseconds
L request time in decimal seconds
p process ID
"""
accesslog = "/home/test/server/log/gunicorn_access.log" #访问⽇志⽂件
errorlog = "/home/test/server/log/gunicorn_error.log" #错误⽇志⽂件。