淺談Django+Gunicorn+Nginx部署之路

更新時間：2019年09月11日 14:49:53 作者：hippie''s Blog

這篇文章主要介紹了Django+Gunicorn+Nginx部署之路，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

前言

最近，我已經(jīng)成功將我的個人網(wǎng)站從 Flask 遷移到 Django 了，最早接觸 Django 的時候大概是在 4 年前，我記得那個時候 Django 中的路由配置使用正則來進行的，但是我有特別煩這個東西，所以就果斷棄坑了。然后今年年初的時候，我用 Flask 寫了一個我的個人網(wǎng)站，剛開始的時候功能還是比較簡單，看著路由配置和部署規(guī)則都很方便，就果斷采用了。但是后來我想添加的功能越來越多的時候，我發(fā)現(xiàn)我已經(jīng)越來越難掌控它了，正好最近我稍微看了一下 Django 這幾年的變化，最新的 2.2 版本還是很不錯的，路由規(guī)則和 Flask 已經(jīng)一致了，所以我就重新入坑了。

目前我的個人網(wǎng)站基本功能已經(jīng)遷移完畢。但是在部署的時候，我遇到了一些問題，在網(wǎng)上看了一些解決方法，要么太亂，要么太舊，個人覺得都已經(jīng)不太適用了。所以在這里記錄一下我的部署過程。

部署

網(wǎng)上有很多都是用 UWSGI 的方式來部署，但是我個人比較喜歡 Gunicorn，所以以下內(nèi)容我只是記錄了 Django + Gunicorn + Nginx 在 Ubuntu 上的部署方式相關(guān)內(nèi)容。

步驟一

上傳網(wǎng)站源碼至目標服務器

由于我的源碼是用 Github 來托管的，所以我直接執(zhí)行下述命令來克隆我的網(wǎng)站源碼到服務器即可。

git clone https://github.com/your-name/repo-name.git

# 進入項目目錄
cd repo-name

# 創(chuàng)建并激活虛擬環(huán)境
python3 -m virtualenv venv
source venv/bin/activate

# 安裝項目依賴
pip install -r requirements.txt

目前我的網(wǎng)站采用的相關(guān)依賴包如下：

autopep8
Django
django-bootstrap4
django-ckeditor
gunicorn
Markdown
Pillow
python-slugify
requests

這里有個坑需要注意，如果你使用了 awesome-slugify，請嘗試使用 python-slugify，因為有的服務器可能無法正常安裝 awesome-slugify，具體 BUG 可參考：Clashes with python-slugify package。

步驟二

修改項目相關(guān)配置，并進行靜態(tài)資源收集

由于我需要將我的網(wǎng)站部署到生產(chǎn)環(huán)境，所以我需要關(guān)閉 Django 的調(diào)試模式，并修改靜態(tài)資源相關(guān)配置，示例配置如下所示：

settings.py

SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY')

DEBUG = os.environ.get('DJANGO_DEBUG', False)

TEMPLATE_DEBUG = os.environ.get('DJANGO_TEMPLATE_DEBUG', False)

ALLOWED_HOSTS = ["*"]

TEMPLATES = [
  {
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'DIRS': [os.path.join(BASE_DIR, 'templates')],
    'APP_DIRS': True,
    'OPTIONS': {
      'context_processors': [
        'django.template.context_processors.debug',
        'django.template.context_processors.request',
        'django.contrib.auth.context_processors.auth',
        'django.contrib.messages.context_processors.messages',
      ],
    },
  },
]

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
STATICFILES_DIRS = [
  os.path.join(BASE_DIR, 'static'),
]

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

然后執(zhí)行如下命令進行靜態(tài)資源收集：

python manage.py collectstatic

之后，我還需要創(chuàng)建一個 Gunicorn 進程的相關(guān)配置，示例配置如下所示：

gunicorn.conf.py

# 安裝
# sudo pip3 install gunicorn

import sys
import os
import logging
import logging.handlers
from logging.handlers import WatchedFileHandler
import multiprocessing

BASE_DIR = '/home/hippie/hippiezhou.fun/src'
sys.path.append(BASE_DIR)

LOG_DIR = os.path.join(BASE_DIR, 'log')
if not os.path.exists(LOG_DIR):
  os.makedirs(LOG_DIR)

# 綁定的ip與端口
bind = "0.0.0.0:8000"

# 以守護進程的形式后臺運行
daemon = True

# 最大掛起的連接數(shù)，64-2048
backlog = 512

# 超時
timeout = 30

# 調(diào)試狀態(tài)
debug = False

# gunicorn要切換到的目的工作目錄
chdir = BASE_DIR

# 工作進程類型(默認的是 sync 模式，還包括 eventlet, gevent, or tornado, gthread, gaiohttp)
worker_class = 'sync'

# 工作進程數(shù)
workers = multiprocessing.cpu_count()

# 指定每個工作進程開啟的線程數(shù)
threads = multiprocessing.cpu_count() * 2

# 日志級別，這個日志級別指的是錯誤日志的級別(debug、info、warning、error、critical)，而訪問日志的級別無法設置
loglevel = 'info'

# 日志格式
access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"'
# 其每個選項的含義如下：
'''
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 = os.path.join(LOG_DIR, 'gunicorn_access.log')
# 錯誤日志文件
errorlog = os.path.join(LOG_DIR, 'gunicorn_error.log')
# pid 文件
pidfile = os.path.join(LOG_DIR, 'gunicorn_error.pid')

# 訪問日志文件，"-" 表示標準輸出
accesslog = "-"
# 錯誤日志文件，"-" 表示標準輸出
errorlog = "-"

# 進程名
proc_name = 'hippiezhou_fun.pid'

# 更多配置請執(zhí)行：gunicorn -h 進行查看

之后可用通過如下方式啟動我們的網(wǎng)站：

# 啟動方式(首先需要切換到項目根目錄，即和 manage.py 在同級目錄下)：

gunicorn -c gunicorn.conf.py website.wsgi:application

# 或
gunicorn website.wsgi:application -b 0.0.0.0:8000 -w 4 -k gthread

# 或
gunicorn website.wsgi:application -b 0.0.0.0:8000 -w 4 -k gthread --thread 40 --max-requests 4096 --max-requests-jitter 512

# 查看進程
ps aux | grep gunicorn

步驟三

配置 Nginx

通過前兩步，我們可以成功將我們的網(wǎng)站跑起來，但是目前還只能在內(nèi)部訪問，所以我們需要通過 Nginx 來做反向代理，供外網(wǎng)訪問。

執(zhí)行下述命令進行安裝和配置

sudo apt-get install nginx

sudo service nginx start

# 備份默認配置
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak

# 啟動 Vim 修改我們的網(wǎng)站配置
sudo vim /etc/nginx/sites-available/default

示例配置如下所示：

server{
    ...
    server_name hippiezhou.fun *.hippiezhou.fun;
    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;
    ...

    location / {
        # First attempt to serve request as file, then
        # as directory, then fall back to displaying a 404.
        # try_files $uri $uri/ =404;
        proxy_pass     http://127.0.0.1:8000; #此處要和你 gunicore 的 ip 和端口保持一致
        proxy_redirect   off;

        proxy_set_header  Host         $host;
        proxy_set_header  X-Real-IP      $remote_addr;
        proxy_set_header  X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header  X-Forwarded-Proto  $scheme;
    }

    location /static {
        alias /root/hippiezhou.fun/src/staticfiles; # 此次需要配置為你的網(wǎng)站對應的靜態(tài)資源的絕對路徑
    }

    location /media {
        alias /root/hipiezhou.fun/src/media; # 如果你的網(wǎng)站有上傳功能，需要配置該結(jié)點并指向目標路徑
    }

    ...
}

配置完成后執(zhí)行下述操作即可將我們的網(wǎng)站運行起來

# 若網(wǎng)站未啟動執(zhí)行該命令
gunicorn -c gunicorn.conf.py website.wsgi:application

sudo nginx -t
sudo service nginx restart

如果不出意外，網(wǎng)站應該是可以正常訪問，如果靜態(tài)資源依然不能訪問，打開網(wǎng)站的開發(fā)者工具看一下是什么錯誤。

如果是 404 的問題，請確保你的 settings 相關(guān)配置和我上面列出來的是一致的；
如果是 403 的問題，應該是 Nginx 無權(quán)訪問你指定的靜態(tài)資源，你需要修改 Nginx 的用戶類型，親執(zhí)行下述命令

sudo vim /etc/nginx/nginx.conf

將 user 后面的值修改為 root，然后重啟 Nginx 即可。

最后，關(guān)于如何配置 HTTPS，這里就不過多介紹了，直接列出相關(guān)示例腳本：

sudo apt-get update
sudo apt-get install software-properties-common
sudo add-apt-repository universe
sudo add-apt-repository ppa:certbot/certbot
sudo apt-get update
sudo apt-get install certbot python-certbot-nginx

sudo certbot --nginx

# sudo certbot renew --dry-run

sudo ufw allow https

sudo systemctl restart nginx

總結(jié)

在部署的過程中，其實遇到最多的問題就是關(guān)于靜態(tài)資源無法問題的問題，但是看到網(wǎng)上很多文章，都不一樣，并且有的寫的還是錯誤的。所以這里就總結(jié)一些。還好，一切順利。算是填了 4 年前的一個坑吧。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: