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是一個wsgi http server,可以如上一章節所示直接起停,提供http服務。
不過在production環境,起停和狀態的監控最好用supervisior之類的監控工具,然後在gunicorn的前端放置一個http proxy server, 譬如nginx。
下面是supervisor和nginx的配置。
supervisor_gunicorn.conf
[program:gunicorn_demo]
process_name=%(program_name)s
numprocs=1
priority=901
directory = /opt/gunicorn_demo/
command = /opt/virtualenv/bin/python /opt/virtualenv/bin/gunicorn -c gunicorn_demo.py gunicorn_demo:app
autostart = true
startsecs = 20
autorestart = true
startretries = 3
user = root
redirect_stderr = true
stdout_logfile_maxbytes = 20MB
stdout_logfile_backups = 10
stdout_logfile = /dev/null
-c gunicorn_demo.py, 即是gunicorn本身的配置文件,下面是gunicorn的基本配置,下一章節會詳細說明gunicorn的配置項。
import multiprocessing
bind = '127.0.0.1:8000'
workers = multiprocessing.cpu_count() * 2 + 1
backlog = 2048
worker_class = "gevent"
worker_connections = 1000
daemon = False
debug = True
proc_name = 'gunicorn_demo'
pidfile = './log/gunicorn.pid'
errorlog = './log/gunicorn.log'
nginx.conf 部分配置
server {
listen 80;
server_name sam_rui.com;
access_log /var/log/nginx/access.log;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
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