Gunicorn 哈街?
Gunicorn“綠色獨角獸”是一個被廣泛使用的高性能的Python WSGI UNIX HTTP服務(wù)器揣苏,移植自Ruby的獨角獸(Unicorn )項目,使用pre-fork worker模式悯嗓,具有部署使用非常簡單,輕量級的資源消耗卸察,以及高性能等特點脯厨。
安裝
系統(tǒng)安裝
sudo apt-get update
sudo apt-get install gunicorn
pip安裝
pip install gunicorn
運行
gunicorn [OPTIONS] 模塊名:變量名
參數(shù):
模塊名:python文件名 或 完整的路徑+python文件名;
變量名:python文件中可調(diào)用的WSGI(Web Server Gateway ).
示例文件:
# filename:test.py
def app(environ, start_response):
"""Simplest possible application object"""
data = 'Hello, World!\n'
status = '200 OK'
response_headers = [
('Content-type','text/plain'),
('Content-Length', str(len(data)))
]
start_response(status, response_headers)
return iter([data])
運行app:
gunicorn --workers=2 test:app
常見[OPTIONS]
參數(shù):
-
-c CONFIG, --config=CONFIG
: 指定配置文件(py文件) -
-b BIND, --bind=BIND
: 與指定socket進(jìn)行綁定. -
-D, --daemon
: 以守護進(jìn)程形式來運行Gunicorn進(jìn)程坑质,其實就是將這個服務(wù)放到后臺去運行合武。 -
-w WORKERS, --workers=WORKERS
: 工作進(jìn)程的數(shù)量。上邊提到gunicorn是一個pre-fork worker模式涡扼,就是指gunicorn啟動的時候稼跳,在主進(jìn)程中會預(yù)先fork出指定數(shù)量的worker進(jìn)程在處理請求時,gunicorn依靠操作系統(tǒng)來提供負(fù)載均衡吃沪,通常推薦的worker數(shù)量是:(2 x $num_cores) + 1
-
-k WORKERCLASS, --worker-class=WORKERCLASS
: 工作進(jìn)程類型. 包括 sync(默認(rèn)), eventlet, gevent, or tornado, gthread, gaiohttp. -
--backlog INT
: 最大掛起的連接數(shù). -
--chdir
: 切換到指定的工作目錄. -
--log-level LEVEL
: 輸出error log的顆粒度汤善,有效的LEVEL有:debug
、info
、warning
红淡、error
不狮、critical
-
--access-logfile FILE
: 確認(rèn)要寫入Access log的文件FILE. '-' 表示輸出到標(biāo)準(zhǔn)輸出. -
--error-logfile FILE, --log-file FILE
: 確認(rèn)要寫入Error log的文件FILE. '-' 表示輸出到標(biāo)準(zhǔn)錯誤輸出.
配置
配置來源:
- 框架設(shè)置
- 配置文件(python文件)
- 命令行
配置文件必須是py文件,本質(zhì)是將命令行參數(shù)寫進(jìn)py文件在旱。
如:
# example.py
bind = "127.0.0.1:8000"
workers = 2
運行g(shù)unicorn:
gunicorn -c example.py test:app
其實等同于:
gunicorn -w 2 -b 127.0.0.1:8000 test:app
也可以詳細(xì)配置:
# gunicorn.py
import logging
import logging.handlers
from logging.handlers import WatchedFileHandler
import os
import multiprocessing
bind = '127.0.0.1:8000' #綁定ip和端口號
backlog = 512 #監(jiān)聽隊列
chdir = '/home/test/server/bin' #gunicorn要切換到的目的工作目錄
timeout = 30 #超時
worker_class = 'gevent' #使用gevent模式摇零,還可以使用sync 模式,默認(rèn)的是sync模式
workers = multiprocessing.cpu_count() * 2 + 1 #進(jìn)程數(shù)
threads = 2 #指定每個進(jìn)程開啟的線程數(shù)
loglevel = 'info' #日志級別颈渊,這個日志級別指的是錯誤日志的級別遂黍,而訪問日志的級別無法設(shè)置
access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"' #設(shè)置gunicorn訪問日志格式,錯誤日志無法設(shè)置
"""
其每個選項的含義如下:
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" #錯誤日志文件