python常見的web部署搭配nginx+gunicorn,下面記錄一下gunicorn的配置使用。
安裝gunicorn
pip install gunicorn
gunicorn -h # 查看使用的命令
gunicorn啟動一個flask的應用程序
# app.py
from flask import Flask
def create_app():
app = Flask(__name__)
return app
app = create_app()
@app.route('/')
def index():
return 'hello world!'
if __name__ == '__main__':
app.run()
- 在flask的項目的目錄下啟動
# 第一個app指的是app.py文件,第二個指的是flask應用的名字;
gunicorn -w 4 -b 0.0.0.0:8000 app:app
gunicorn的參數詳解
-c CONFIG : CONFIG,配置文件的路徑,通過配置文件啟動;生產環境使用;
-b ADDRESS : ADDRESS,ip加端口,綁定運行的主機;
-w INT, --workers INT:用於處理工作進程的數量,為正整數,默認為1;
-k STRTING, --worker-class STRTING:要使用的工作模式,默認為sync異步,可以下載eventlet和gevent並指定
--threads INT:處理請求的工作線程數,使用指定數量的線程運行每個worker。為正整數,默認為1。
--worker-connections INT:最大客戶端並發數量,默認情況下這個值為1000。
--backlog int:未決連接的最大數量,即等待服務的客戶的數量。默認2048個,一般不修改;
-p FILE, --pid FILE:設置pid文件的文件名,如果不設置將不會創建pid文件
--access-logfile FILE : 要寫入的訪問日志目錄
--access-logformat STRING:要寫入的訪問日志格式
--error-logfile FILE, --log-file FILE : 要寫入錯誤日志的文件目錄。
--log-level LEVEL : 錯誤日志輸出等級。
--limit-request-line INT : HTTP請求頭的行數的最大大小,此參數用於限制HTTP請求行的允許大小,默認情況下,這個值為4094。值是0~8190的數字。
--limit-request-fields INT : 限制HTTP請求中請求頭字段的數量。此字段用於限制請求頭字段的數量以防止DDOS攻擊,默認情況下,這個值為100,這個值不能超過32768
--limit-request-field-size INT : 限制HTTP請求中請求頭的大小,默認情況下這個值為8190字節。值是一個整數或者0,當該值為0時,表示將對請求頭大小不做限制
-t INT, --timeout INT:超過這么多秒后工作將被殺掉,並重新啟動。一般設定為30秒;
--daemon: 是否以守護進程啟動,默認false;
--chdir: 在加載應用程序之前切換目錄;
--graceful-timeout INT:默認情況下,這個值為30,在超時(從接收到重啟信號開始)之后仍然活着的工作將被強行殺死;一般使用默認;
--keep-alive INT:在keep-alive連接上等待請求的秒數,默認情況下值為2。一般設定在1~5秒之間。
--reload:默認為False。此設置用於開發,每當應用程序發生更改時,都會導致工作重新啟動。
--spew:打印服務器執行過的每一條語句,默認False。此選擇為原子性的,即要么全部打印,要么全部不打印;
--check-config :顯示現在的配置,默認值為False,即顯示。
-e ENV, --env ENV: 設置環境變量;
以配置文件的方式啟動
# gunicorn.conf
# 並行工作進程數
workers = 4
# 指定每個工作者的線程數
threads = 2
# 監聽內網端口5000
bind = '127.0.0.1:5000'
# 設置守護進程,將進程交給supervisor管理
daemon = 'false'
# 工作模式協程
worker_class = 'gevent'
# 設置最大並發量
worker_connections = 2000
# 設置進程文件目錄
pidfile = '/var/run/gunicorn.pid'
# 設置訪問日志和錯誤信息日志路徑
accesslog = '/var/log/gunicorn_acess.log'
errorlog = '/var/log/gunicorn_error.log'
# 設置日志記錄水平
loglevel = 'warning'
- 啟動unicorn
gunicorn -c gunicorn.conf app:app
注意:
由於windows平台不支持gunicorn,gunicorn安裝成功后,啟動會出現
‘ImportError: No module named _curses / fcntl’錯誤;需要下載fcntl.py文件;