python gunicorn詳解

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配置項能夠經過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

Gunicorn配置

　Gunicorn從三個不一樣的地方讀取配置信息。

　第一個地方:從framework定義的配置信息中讀取,目前只對 Paster 框架有效。

　第二個地方:在命令行中定義,命令行中定義的配置信息將會覆蓋掉框架中定義的相同的參數名的值。

　最後:將全部的參數信息,放到一個文件中,只要是在命令行中能夠定義的參數中,在配置文件中均可以定義。(是一個Python源文件,因此你就像在寫Python代碼同樣)

　第一個地方不不介紹了,不實用。重點介紹第二種和第三種,其實這兩種方式都是相同的。

　顯示說有配置選項:

gunicorn -h

使用命令行配置:

在上面的 myapp 例子的基礎上

gunicorn --workers=4 --bind=127.0.0.1:8000 myapp.test:app

上面的命令 啓動 4個 workers ,綁定到 127.0.0.1：8000

  配置文件 config.py 源碼

import multiprocessing 

bind = "127.0.0.1:8001"
workers = multiprocessing.cpu_count() * 2 + 1

使用配置文件啓動Gunicorn

gunicorn --config=config.py myapp.test:app

和上面用命令行配置的效果徹底同樣，固然二者還能夠結合起來用:

gunicorn --config=gunicorn_conf.py --worker-class=eventlet myapp.test:app

worker-class默認是sync(同步),咱們配置成了 eventlet(併發的)

 

本人本身運營一個淘寶店，若是你以爲文章寫得好。幫忙給淘寶店點個關注。謝謝

連接： https://shop211977203.taobao.com/