專案體驗地址:175.27.165.229
目錄
一. 任務概述
二. 架構設計
三. 創建和開發Django專案
3.1 創建Django專案
3.2 專案開發
3.2.1 加載文字
3.2.2 靜態資源匯入
四、Nginx+uWSGI生產級部署
4.1 安裝Nginx
4.2 協同部署
4.3 uwsgi后臺運行
五. 小結
一. 任務概述
最近準備將原有Django專案遷移到騰訊云的Ubuntu上面去,以前在部署Django應用的時候主要采用Windows的IIS進行部署,為了便于今后操作,本文詳細記錄在Ubuntu的部署流程,
二. 架構設計
整體的設計架構圖如下所示:

Django 的部署可以有很多方式,采用 nginx + uwsgi 的方式是其中比較常見的一種方式,在這種方式中,我們的通常做法是,將 nginx 作為服務器最前端,它將接收 web 的所有請求,通過負載均衡(如果有多臺服務器的話)統一管理請求,同時nginx 把所有靜態請求(主要是圖片、css樣式、字體檔案等)自己快取自己來處理(nginx處理靜態檔案性能非常強),接下來,nginx 將所有非靜態請求傳給 uwsgi 來進行處理,uwsgi可以理解為是支撐django的生產級服務器,穩定性和并發性都非常好,通過這樣的兩級服務器支持,我們可以極大的提高網站訪問的穩定性和訪問性能,nginx和uwsgi之間一般處于內網環境,使用socket來代替http進行通信,速度極快,
有人會有疑問,為什么不用django自帶的開發服務器然后通過命令列python manage.py runserver來啟動呢?這是因為django自帶的開發者服務器性能比較差,只能用來除錯代碼,真實生產級環境中無法滿足高并發的要求,
三. 創建和開發Django專案
開發環境:Django3.2.10、Python3.6
遠程登錄軟體:基于SSH 的MobaXterm
云服務器:Ubuntu server18.04
3.1 創建Django專案
Django是一個基于Python的Web框架,使用Django可以方便、快捷的創建網站等網路應用,本文僅介紹與本章內容相關的Django部署知識,如果想要深入學習Django的讀者可以參考我的Django系列教程或者參考我的書籍《python web開發從入門到實戰》
首先安裝Django:
pip3 install django==3.2.10
然后我們創建Django專案,專案名稱為blog:
python3 /home/ubuntu/.local/lib/python3.6/site-packages/django/bin/django-admin.py startproject blog
上述命令注意要找到云服務器上django的安裝路徑,可以參考上面給出的路徑,
此時會自動創建photoweb專案,進入該專案:
cd blog
接下來為該專案創建一個應用:
python3 manage.py startapp app
打開blog/blog/settings.py檔案,添加應用同時放開訪問權限:
ALLOWED_HOSTS = ['*',]
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'app',# 添加應用
]
接下來可以啟動專案:
python3 manage.py runserver 0.0.0.0:8000
此時,我們可以通過公網ip遠程訪問這個開發者服務器:http://175.27.165.229:8000/
正常情況下會出現下圖所示界面:

說明此時我們在騰訊云上成功創建了一個最簡單的示例網站,并且可以簡單訪問了,
如果上述步驟沒有成功,那么需要查看購買的云服務器上8000埠是否已放開,需要登錄云服務器控制臺將埠開通,每個云服務器提供商對于埠的開通情況不一致,我在使用騰訊云的時候沒有這個問題,百度云需要自己開通8000埠,
3.2 專案開發
本小節我們繼續加強我們的django應用,最終實作一個基本的個人站點,可以多頁面顯示和資料庫訪問,由于需要遠程編輯代碼,這里推薦使用VS Code的遠程除錯功能,比較方便編輯代碼,
3.2.1 加載文字
打開blog/app/views.py檔案,添加視圖介面函式:
from django.shortcuts import render
# Create your views here.
def home(request):
return render(request,'home.html')
這里我們希望通過render函式直接渲染home.html頁面,
我們在app檔案夾下新建名為templates的子檔案夾,然后在templates檔案夾中添加對應的home.html檔案,這個檔案可以隨便從網上下載一個html網站模板即可,我們后面會講解如何對其修改使得django能夠正常渲染,這里我們先把免費的html網站首頁的html檔案拷貝到templates檔案夾中然后修改名稱為home.html即可,
為了能夠順利的訪問圖片等靜態資源,我們在app目錄下創建static檔案夾,然后將網站對應的靜態資源(css、js、img等)拷貝到該static檔案夾下面,
最終完整目錄如下所示:

接下來我們為新添加的視圖處理函式添加對應的路由,打開blog/urls.py檔案,添加路由如下:
from app.views import home
urlpatterns = [
...其它路由...
path('', home, name='home'),
]
這里默認使用根網址,保存所有修改后啟動專案:
python3 manage.py runserver 0.0.0.0:8000
然后通過外網訪問這個網站:
http://175.27.165.229:8000/
效果如下所示:

可以看到頁面文字都顯示出來了,但是頁面的靜態資源檔案沒有加載成功,下面我們繼續完善,
3.2.2 靜態資源匯入
前面已經將網站需要的css、圖片等靜態資源放在了app/static目錄下面,首先我們要做的就是確定部署環境時的靜態資源路徑,
打開settings.py檔案,添加代碼如下:
import os
STATIC_URL = '/static/'
STATIC_ROOT= os.path.join(BASE_DIR,'static')
接下來我們進行靜態檔案遷移(把app下的static靜態資源統一遷移到根目錄下的static檔案夾中):
python3 manage.py collectstatic
正常情況下效果如下:

接下來修改html模板,主要修改如下:
(1)頭部靜態標簽引入
在html頭部引入靜態資源標簽,類似于java web的jsp語法:
{% load static %}
注意,這里我們采用的是django3進行部署,如果是django2,那么需要采用下面的語法:
{% load staticfiles %}
(2)靜態資源參考
修改所有靜態資源參考的地方,主要包括js、css、img等的引入,具體示例如下:
- css檔案
<link rel="stylesheet" href="css/bootstrap.min.css" />
替換為:
<link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}" />
- js檔案
<script src="js/jquery-1.11.0.min.js"></script>
替換為:
<script src="{% static 'js/jquery-1.11.0.min.js' %}"></script>
- img圖片:
<img src="img/01.jpg" alt="Image 1" class="" />
替換為:
<img src="{% static 'img/01.jpg' %}" alt="Image 1" class="" />
改完以后重新啟動,重繪頁面,可以看到效果如下所示:

所有效果和樣式都已經正常了,這里我們就在云上基于開發者服務器部署完了,
四、Nginx+uWSGI生產級部署
目前,我們使用的django是采用其默認的開發者服務器進行部署的,這種部署方式不適合高并發需求,穩定性較差,本小節我們將采用nginx + uwsgi 來進行生產級部署,
4.1 安裝Nginx
sudo apt-get install nginx
安裝好后我們可以檢測下nginx版本號:
nginx -v
效果如下所示:
![]()
接下來啟動nginx:
sudo service nginx start
啟動后nginx默認會開啟一個站點,埠在80,我們可以通過外網訪問:175.27.165.229:80/
出現下圖所示表示啟動成功:

4.2 協同部署
首先安裝uwsgi:
sudo pip3 install uwsgi
然后在 Django 專案根目錄下新建一個 uWSGI 的組態檔 uwsgi.ini:
cd blog
touch uwsgi.ini
接下來打開剛剛創建好的組態檔 uwsgi.ini 添加如下配置:
[uwsgi]
socket = :8888
chdir = /home/ubuntu/code/blog
module = blog.wsgi
master = true
processes = 1
vacuum = true
接下來配置Nginx,
Nginx 默認的組態檔都在 /etc/nginx 目錄下,我們需要進入 /etc/nginx/sites-available 目錄下進行配置 default 檔案,
首先將原有組態檔進行備份,并打開 nginx 組態檔
sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak
sudo vim /etc/nginx/sites-available/default
刪掉原先的內容,添加配置如下:
server {
listen 80;
server_name 175.27.165.229;
charset UTF-8;
access_log /var/log/nginx/blog_access.log;
error_log /var/log/nginx/blog_error.log;
client_max_body_size 75M;
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:8888;
uwsgi_read_timeout 10;
#uwsgi_max_temp_file_size 0; # 禁用臨時檔案緩沖器
}
location /static {
expires 30d;
autoindex on;
add_header Cache-Control private;
alias /home/ubuntu/code/blog/static;
}
}
上述配置不難分析,nginx本身配置在80埠,用于接收所有從80埠來的請求,然后轉發給uwsgi對應的8888埠,如果是靜態資源,則直接使用nginx進行回傳(location /static指明了靜態檔案路徑),
現在重新啟動 nginx:
sudo service nginx restart
然后啟動uwsgi,具體的通過 uwsgi 命令讀取前面創建的 uwsgi.ini 檔案啟動專案:
sudo uwsgi --ini uwsgi.ini
注意這里的ini檔案里面我們把uwsgi的啟動埠設定為了8888,
正常狀態內容如下所示:

注意查看uwsgi的啟動資訊,如果有錯,就要檢查組態檔的引數是否設定有誤,
到這里我們就基本部署完成了,
這個時候我們通過外網訪問http://175.27.165.229/ 進行測驗,效果如下圖所示:

可以可以正常訪問文字頁面,但是css、圖片等靜態資源沒有加載進來,
我們可以查看nginx錯誤日志,位于/var/log/nginx/blog_error.log,打開后內容如下所示:
2022/01/01 22:22:48 [error] 11674#11674: *41 open() "/home/ubuntu/code/blog/static/slick/slick.min.js" failed (13: Permission denied), client: 112.22.88.175, server: 175.27.165.229, request: "GET /static/slick/slick.min.js HTTP/1.0", host: "175.27.165.229", referrer: "http://175.27.165.229/"
2022/01/01 22:22:48 [error] 11674#11674: *42 open() "/home/ubuntu/code/blog/static/jquery.magnific-popup.min.js" failed (13: Permission denied), client: 112.22.88.175, server: 175.27.165.229, request: "GET /static/jquery.magnific-popup.min.js HTTP/1.0", host: "175.27.165.229", referrer: "http://175.27.165.229/"
可以看到所有靜態資源請求均提示Permission denied,這是nginx權限問題,我們使用下面的命令查看當前nginx權限用戶:
ps aux | grep "nginx: worker process"
可以看到我們當前id=11674作業的nginx用戶名是www-data,并不是ubuntu(騰訊云ubuntu系統默認賬戶名為ubuntu),因此我們需要將nginx的作業用戶改為ubuntu即可,
具體操作如下:
sudo su
cd /etc/nginx
vim nginx.conf
在打開的檔案里面將user www-data; 修改為 user root;即可,
然后重新加載nginx:
nginx -s reload
接下來我們重新訪問,即可看到頁面如下:

到這里圖片和css樣式等都能準確加載了,
4.3 uwsgi后臺運行
最后,我們還遺留了一個問題,我們是采用遠程ssh方式啟動uwsgi的,一旦我們的ssh關閉,會發現這個啟動的uwsgi也就關掉了,因此,我們希望通過ssh將uwsgi啟動并能夠在后臺一直運行,
我們可以使用下面的命令啟動uwsgi并且能夠在后臺運行:
sudo uwsgi -d --ini uwsgi.ini
這個時候我們關掉ssh,可以看到網站依然可以訪問,
如果我們想要關掉已經在后臺運行的uwsgi,那么可以使用下面的方法:
首先查詢當前所有正在運行的uwsgi:
ps -ef|grep uwsgi
效果如下:

其中第2串列示行程號,我們可以直接將其kill掉:
sudo kill -9 23559
五. 小結
本文主要講解如何在騰訊云的ubuntu上實作django的生產級部署,由于水平有限,本文難免有錯誤或不當的地方,請讀者予以指正,
轉載請註明出處,本文鏈接:https://www.uj5u.com/ruanti/401607.html
標籤:其他
