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安装
由于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 Manager

app = Flask(__name__)
manager = Manager(app)

@app.route("/")
def index():
    return "
Hello world
"


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

注意:

1. 如果报错 未找到gevent,需要在当前虚拟环境中安装模块:

   pip install gevent

2. chdir 目录必须修改指向当前工作目录，日志文件指向路径必须可用

3. 运行成功时命令行不会有输出

4. 错误无法解决,试试清除当前文件目录的__pycache__文件夹和浏览器缓存
   运行结果:
   
   
   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/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 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/python/PycharmProjects/News-Information/log/gunicorn_access.log"  # 访问日志文件
    errorlog = "/home/python/PycharmProjects/News-Information/log/gunicorn_error.log"