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安装
由于Windows上不支持gunicorn,故以下代码在Linux下执行有效!
前提是安装好python,在虚拟环境中运行:
pip install gunicorn
执行:gunicorn -h
代表gunicorn执行成功!
3. 编写flask代码,flask-gunicorn.py代码如下
需要在虚拟环境中安装 :
pip install flask-script
from flask import Flask
from flask_script import Managerapp = Flask(__name__)
manager = Manager(app)@app.route("/")
def index():return "<h1>Hello world<h1>"if __name__ == '__main__':manager.run()
4. 使用gunicorn监听请求,运行以下命令
gunicorn -w 2 -b 127.0.0.1:4000 flask-gunicorn:app
运行结果:
-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 = "127.0.0.1:8000"
workers = 2
运行以下命令:
gunicorn -c gunicorn.conf.py flask-gunicorn:app
注意:
-
如果报错 未找到gevent,需要在当前虚拟环境中安装模块:
pip install gevent
-
chdir 目录必须修改指向当前工作目录,日志文件指向路径必须可用
-
运行成功时命令行不会有输出
-
错误无法解决,试试清除当前文件目录的__pycache__文件夹和浏览器缓存
运行结果:
gunicorn配置文件是一个python文件,因此可以实现更复杂的逻辑,如下:# gunicorn.conf.pyimport loggingimport logging.handlersfrom logging.handlers import WatchedFileHandlerimport osimport multiprocessingbind = '127.0.0.1:8000' # 绑定ip和端口号backlog = 512 # 监听队列chdir = '/home/python/PycharmProjects/News-Information' # 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 addressl '-'u currently '-', may be user name in future releasest date of the requestr status line (e.g. ``GET / HTTP/1.1``)s statusb response length or '-'f referera user agentT request time in secondsD request time in microsecondsL request time in decimal secondsp process ID"""accesslog = "/home/python/PycharmProjects/News-Information/log/gunicorn_access.log" # 访问日志文件errorlog = "/home/python/PycharmProjects/News-Information/log/gunicorn_error.log"