一學就會的django專案伺服器部署nginx-uwsgi-django/build

中乘風發表於2018-07-13

一、前言

需要在阿里雲伺服器部署Django-restframework框架,一開始不清楚情況,網上找了很多的文章和辦法,東拼西湊也沒有能夠完全實現nginx和uwsgi的互通。

想學會?

你需要找一個乾乾淨淨的、沒有安裝其他東西的Linux伺服器(Centos系統)來跟著這篇文章做。

參考過的文章有

-視訊:Nginx + uWsgi 部署 Django + Mezzanine 生產伺服器

-文章:uWSGI+django+nginx的工作原理流程與部署歷程

-文章:uwsgi官方文件

-文章:Django Nginx+uwsgi 安裝配置

-文章:centos7 下通過nginx+uwsgi部署django應用

二、網上文章的遺漏

因為是東拼西湊,所以無論是網上的文章還是自己拼湊的配置,都是沒有辦法打通的。後來紅包求助,才瞭解到有這幾個地方:

1、nginx執行許可權

2、uwsgi配置

3、uwsgi設定虛擬環境

4、uwsgi安裝問題及外掛安裝問題

5、django靜態檔案收集處理

三、部署安裝記錄

1、建立非管理員賬戶

由於安全需求,還是配置一個非管理員(自己操作,增加sudo授權)賬戶操作,通過命令建立使用者名稱密碼

adduser quinns  # 新增使用者

passwd quinns  # 為quinns設定密碼

設定好之後,還需要開啟sudo許可權,通過命令:

vi /etc/sudoers

然後找到有 root ALL=(ALL)那一行,然後在下面增加一行:

quinns ALL=(ALL)  ALL

儲存即可。

下面的操作,用新使用者quinns登入來操作。

2、安裝依賴

uwsgi和nginx以及anaconda的安裝會存在一些報錯問題,這裡為了避免出現這情況,所以先安裝好依賴。

sudo yum install gcc-c++

sudo yum install wget openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel

sudo yum install uwsgi-plugin-python

sudo yum install libxml*

sudo yum install -y bzip2

sudo yum -y install pcre-devel

sudo yum install python-devel

sudo yum install build-essential python-dev

3、安裝軟體

通過quinns賬戶登入,然後到quinns使用者目錄(/home/quinns)下新建一個utils目錄,把一些軟體下載在utils目錄下。

3.1安裝anaconda

通過wget方式下載anaconda(官網)

wget https://repo.continuum.io/archive/Anaconda3-5.0.1-Linux-x86_64.sh

如果想更快,就安裝國內源(清華映象):

wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-5.1.0-Linux-x86_64.sh

下載好之後sh安裝

sh Anaconda3-5.0.1-Linux-x86_64.sh

一路預設,到之後面安裝完的時候會提示是否新增環境變數,輸入yes即可。

如果想要後面使用更快,可以更改倉庫映象:

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --set show_channel_urls yes

這樣的話安裝軟體都是國內源,速度比較快

3.2驗證是anaconda否成功安裝

通過命令:

conda list

來驗證是否成功安裝並加入環境變數,如果出現list列表則代表成功,如果出現報錯提示資訊則需要用命令:

source ~/.bashrc

來新增,然後重複conda list命令。如果還是不行,則編輯/etc/profile檔案,在底部新增環境變數及指向:

export PATH=/home/quinns/anaconda3/bin:$PATH

通過檔案新增的環境變數需重啟伺服器才能生效

3.3安裝uwsgi

在確認安裝好anaconda之後,先不著急新建虛擬環境,直接在linux下輸入python,檢查預設python是否已自動替換為python3.6。接著通過pip安裝uwsgi:

pip install uwsgi

待有安裝成功的提示出來,再通過命令:

uwsgi --version

來確認是否成功安裝。

3.4建立虛擬環境

通過anaconda來建立python虛擬環境:

conda create --name envname python=3.6.3

(親身經歷 3.6.5無法啟動uwsgi,最好還是3.6.3)

觀察過程,無報錯即完成安裝。

3.5安裝nginx

直接通過yum來安裝nginx即可,如果想安裝新版,可以在網上尋找新方法。

sudo yum install nginx

安裝完成後應該是自動啟動服務,在瀏覽器輸入ip即可訪問nginx的歡迎頁面。如果沒有,通過命令:

sudo service nginx start/restart

來啟動或者重啟nginx服務。

3.6安裝mysql

先下載mysql的repo源

wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm

接著安裝mysql-community-release-el7-5.noarch.rpm包

sudo rpm -ivh mysql-community-release-el7-5.noarch.rpm

安裝這個包後,會獲得兩個mysql的yum repo源:/etc/yum.repos.d/mysql-community.repo,/etc/yum.repos.d/mysql-community-source.repo。

最後執行安裝

sudo yum install mysql-server

3.7重置mysql密碼

先授權

sudo chown -R root:root /var/lib/mysql

service mysqld restart  # 然後重啟

接著重置密碼

mysql -u root  //直接回車進入mysql控制檯
mysql > use mysql;
mysql > update user set password=password(`quinns`) where user=`root`;
mysql > exit;

service mysqld restart  # 然後再重啟一次服務

3.8開啟遠端訪問

mysql預設是不開啟遠端訪問的,想要在本地連線伺服器的mysql,必須開啟:

mysql -u root -p

mysql> use mysql;
mysql> update user set host = `%` where user = `root`;

service mysqld restart  # 這裡也要重啟一次服務

(過30秒或者1分鐘再測試遠端連線)如果不行的話,接著重啟服務一次。

四、uwsgi服務測試

安裝好這些軟體後,需要確保獨立服務都是正常執行的。

在/home/quinns目錄下新建wwwroot目錄,然後在裡面新建一個測試檔案uwsgitest.py

def application(env, start_response):
    start_response(`200 OK`, [(`Content-Type`,`text/html`)])
    return [b"Hello World, This uwsgi server is running"]

儲存後通過命令來啟動

uwsgi --http :8000 --wsgi-file uwsgitest.py

看到服務啟動後,就可以在瀏覽器訪問8080埠,如果能夠正常顯示文字內容,則代表uwsgi單獨服務是可以正常執行的。如果沒有,根據報錯找原因。

五、上傳django-rest專案

可以在本地,通過ssh對伺服器進行連線,其中也包括上傳下載服務。

本地開啟終端後輸入:

scp -r djangoName quinns@47.98.xxx.xxx:/home/quinns/wwwroot

將當前目錄的djangoName資料夾通過quinns賬戶上傳到/home/quinns/wwwroot目錄內。回車執行後輸入quinns的密碼即可看到上傳到指定的wwwroot目錄內。

六、配置django

本地開發環境下的django和伺服器的設定有些許不一樣。

首先要開放ALLOWED_HOSTS,使得程式可以遠端訪問,然後再設定靜態檔案,最後再通過命令來測試是否可以順利啟動。

開啟drf遠端訪問及靜態設定

找到django專案的settings.py檔案,裡面有個ALLOWED_HOSTS,是接收一個空列表,現在要將伺服器地址或者域名新增進去(也可以放*號,代表所有都可以指向這裡,但是不推薦這麼做):

ALLOWED_HOSTS = [`47.98.xxx.xxx`]

上面就算是開啟了遠端訪問,接著設定靜態(drf有一些樣式,如果不設定,通過uwsgi啟動是無法載入的)。同樣是在settings.py檔案中,下部分程式碼中有個STATIC_URL = `/static/`,在它下面新增一行:

STATIC_ROOT = os.path.join(BASE_DIR, "static/")

儲存檔案,然後在虛擬環境下執行命令:

python manage.py collectstatic

這樣django就會收集靜態檔案,放到指定目錄內,也就是(static目錄內)

七、編寫uwsgi配置

uwsgi可以通過命令來啟動django專案,也可以通過配置檔案ini或者xml來啟動。這裡已ini為例。

在專案根目錄(manage.py同目錄,其實哪個目錄都可以,這裡是方便尋找)新建資料夾conf,然後再在conf下新建uwsgi資料夾(這倆資料夾什麼名字無所謂)。接著新建uwsgi的配置檔案,這裡暫且叫做lagou_uwsgi.ini 裡面寫上uwsgi與專案的配置資訊:

ite_uwsgi.ini file`
    [uwsgi]

    # Django-related settings
    # the base directory (full path)
    chdir           = /home/quinns/wwwroot/GamesAPI
    # Django`s wsgi file
    module          = GamesAPI.wsgi
    # the virtualenv (full path)

    # process-related settings
    # master
    master          = true
    # maximum number of worker processes
    processes       = 4
    threads         = 2
    # the socket (use the full path to be safe
    socket          = 127.0.0.1:8001
    # ... with appropriate permissions - may be needed
    # chmod-socket    = 664
    # clear environment on exit
    vacuum          = true
  virtualenv = /home/quinns/anaconda3/envs/envgames
    python-autoreload=1

    logto = /home/quinns/wwwroot/GamesAPI/uwsgilog.log

    stats = %(chdir)/conf/uwsgi/uwsgi.status
    pidfile = %(chdir)/conf/uwsgi/uwsgi.pid

具體的含義在uwsgi文件都有,這裡記錄一下:

chdir # 專案絕對路徑

module  # 專案內的uwsgi.py檔案,其實與專案同名即可

master

processes

threads

socket # 服務啟動地址及埠

vacuum

virtualenv # 這個就很重要了,python虛擬環境地址

python-autoreload=1 # python自啟動

logto # 自動生成日誌檔案及存放路徑

stats

pidfile

這就算是編寫好uwsgi的配置檔案了,接著編寫nginx的配置。

八、單專案nginx配置

最好不要改動原有的ningx,來新建一個新的.conf配置檔案吧。同樣在專案目錄的conf目錄內新建nginx資料夾,然後再在nginx資料夾裡新建lagou.conf配置檔案,裡面寫上nginx的配置:

upstream games {
# server unix:///path/to/your/mysite/mysite.sock; # for a file socket
server 127.0.0.1:8001; # uwsgi的埠
}
# configuration of the server

error_log  /home/quinns/wwwroot/nginxerror.log;#錯誤日誌
server {
# the port your site will be served on
listen      8080;
# 埠
server_name 47.98.xxx.xxx ; # 伺服器ip或者域名
charset     utf-8;

# max upload size
client_max_body_size 75M;   # adjust to taste


# Django media
location /media  {
    alias  /home/quinns/wwwroot/GamesAPI/media;  # 指向django的media目錄
}

# Django static
location /static  {
    alias  /home/quinns/wwwroot/GamesAPI/static;  # 指向django的static目錄
}

# Finally, send all non-media requests to the Django server.
location / {
    uwsgi_pass  games;
    include     uwsgi_params; # uwsgi服務
}
}

裡面都有說明了,我就不寫了。其的upstream games中的games是自定義名稱,但是要與下面的uwsgi_pass games中games名稱相同。

注意: .conf檔案建立好後,要與讓nginx知道並承認,所以需要通過軟連線來連結到/etc/nginx/conf.d/目錄下,如果不知道軟連線怎麼做,可以把這個檔案copy到這個目錄下。

然後重啟伺服器

sudo service nginx restart

如果沒有報錯,應該就是可以了。

如果有報錯,沒有重啟ng伺服器,那肯定是配置檔案寫錯了,得去看一下。

九、啟動專案

既然uwsgi也配置好了,django專案的虛擬環境也pip install -r requirements.txt過了,ng的配置檔案也寫好了。那就可以啟動服務了。

nginx的服務啟停

通過linux命令來進行啟停

sudo service nginx restart/start/stop

如果之前啟動過,就不用重啟了。

uwsgi啟動專案

找到剛才編寫的lagou_uwsgi.ini配置檔案目錄,通過命令來啟動:

uwsgi -i lagou_uwsgi.init &

如果沒有報錯,就代表啟動了。就可以在瀏覽器訪問之前.conf配置檔案配置的8080埠了。

十、nginx配置靜態

後端api沒有問題後,前端也要部署。

前端通過npm run build打包之後,將build檔案通過ssh上傳到wwwroot目錄下:

scp -r build quinns@xx.xx.xx.xx:/home/quinns/wwwroot

等到上傳完成後,就到nginx那裡進行靜態的部屬配置

cd /etc/nginx

然後開啟nginx.conf檔案進行編輯。

首先要給nginx檔案進行訪問授權,否則有些目錄是會報錯403的。其配置檔案中有:

user nginx;

這裡得給他改成使用者的許可權,如quinns或者root

user quinns;

看到server部分的程式碼:

server {
    listen       80 default_server;
        listen       [::]:80 default_server;
        server_name  _;
        root         /usr/share/nginx/html;
        
        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {

        }
……
    ……
}

是這樣的,訪問網址80埠預設指向/usr/share/nginx/html目錄下的index.html

因為靜態打包後build也是由index.html來作為主入口的。所以這裡只需要把root的指向改過來即可:

server {
    listen       80 default_server;
        listen       [::]:80 default_server;
        server_name  _;
        #root         /usr/share/nginx/html;
        root          /home/quinns/wwwroot/build;
        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {

        }
……
    ……
}

將原來的root指向註釋掉,增加build資料夾的指向

然後重啟nginx服務,開啟瀏覽器訪問,就可以看正常的頁面了。

心中一陣竊喜,這個坑終於是填上了。


相關文章