萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python Web App 生產環境部署完整指南:Nginx + Gunicorn + Supervisor + Fabric 自動化

完成本地開發只是開始,將 Web App 部署到生產環境才能服務真實用戶。本文以 awesome-python-webapp 為例,完整記錄從零構建 Ubuntu Server、配置 Nginx 反向代理、Gunicorn WSGI 伺服器、Supervisor 進程監控,到 Fabric 自動化部署腳本的全流程最佳實踐。

架構總覽

用戶請求 → Nginx (靜態資源 + 反向代理) → Gunicorn (Master-Worker) → Python App
                    ↑
              Supervisor (進程監控、自動重啟)

伺服器環境準備

  • OS:Ubuntu Server 12.04 LTS(或更新版 LTS)
  • SSH 金鑰免密登入:ssh-copy-id user@server
  • 安裝核心服務:
$ sudo apt-get install nginx gunicorn python-gevent supervisor mysql-server
$ sudo apt-get install python-jinja2 python-mysql.connector

目錄結構與版本化部署

/
└── srv/
    └── awesome/          <-- Web App 根目錄
        ├── www/          <-- 當前版本軟連結 → releases/20240115_1430/
        ├── releases/     <-- 歷史版本目錄
        │   ├── 20240115_1430/
        │   └── 20240114_2200/
        ├── log/          <-- 日誌目錄
        └── static/       <-- 靜態資源(由 Nginx 直接服務)

軟連結策略:新版本解壓至 releases/,切換 www 指向即完成部署,回滾只需切回舊連結。

Nginx 設定重點

server {
    listen 80;
    server_name yourdomain.com;
    root /srv/awesome/www;
    location /static/ { expires 30d; }
    location / {
        proxy_pass https://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Gunicorn + Gevent 高併發配置

# /etc/supervisor/conf.d/awesome.conf
[program:awesome]
command = /srv/awesome/www/venv/bin/gunicorn -w 4 -k gevent -b 127.0.0.1:9000 wsgi:app
directory = /srv/awesome/www
user = www-data
autostart = true
autorestart = true
redirect_stderr = true
stdout_logfile = /srv/awesome/log/gunicorn.log
  • -k gevent:無需修改同步代碼即獲得協程級併發
  • -w 4:Worker 數通常設為 CPU 核心數 × 2

Fabric 自動化部署腳本 (fabfile.py)

# fabfile.py
from fabric.api import *
import os, re
from datetime import datetime

env.user = 'deploy'
env.sudo_user = 'root'
env.hosts = ['your.server.ip']

_TAR_FILE = 'dist-awesome.tar.gz'
_REMOTE_BASE = '/srv/awesome'

def build():
    includes = ['static', 'templates', 'transwarp', 'favicon.ico', '*.py']
    excludes = ['test', '.*', '*.pyc', '*.pyo']
    local('rm -f dist/%s' % _TAR_FILE)
    with lcd(os.path.join(os.path.abspath('.'), 'www')):
        cmd = ['tar', '--dereference', '-czvf', '../dist/%s' % _TAR_FILE]
        cmd.extend(['--exclude=%s' % ex for ex in excludes])
        cmd.extend(includes)
        local(' '.join(cmd))

def deploy():
    newdir = 'www-%s' % datetime.now().strftime('%y-%m-%d_%H.%M.%S')
    run('rm -f %s/%s' % (_REMOTE_BASE, _TAR_FILE))
    put('dist/%s' % _TAR_FILE, '%s/%s' % (_REMOTE_BASE, _TAR_FILE))
    with cd(_REMOTE_BASE):
        sudo('mkdir %s' % newdir)
        sudo('tar -xzf %s -C %s' % (_TAR_FILE, newdir))
        sudo('rm -f www')
        sudo('ln -s %s www' % newdir)
        sudo('supervisorctl restart awesome')
        sudo('nginx -s reload')
    print('Deploy success: %s' % newdir)

部署僅需一條指令:

$ fab build deploy

資料庫初始化

$ mysql -u root -p < schema.sql

關鍵最佳實踐總結

  1. 不可變部署:版本目錄 + 軟連結,支援秒級回滾
  2. 進程監控:Supervisor 確保服務自愈
  3. 靜態資源分離:Nginx 直接服務,減輕 Python 進程負載
  4. 自動化腳本:Fabric 消除人為錯誤,支援 CI/CD 整合
  5. DevOps 思維:開發階段即考慮部署、監控、擴容需求
copyright © 萬盛學電腦網 all rights reserved