nginx+uWSGI+django+virtualenv+supervisor


 

 導論

WSGI是Web服務器網關接口。它是一個規范,描述了Web服務器如何與Web應用程序通信,以及Web應用程序如何鏈接在一起以處理一個請求,(接收請求,處理請求,響應請求)
基於wsgi運行的框架有bottle,DJango,Flask,用於解析動態HTTP請求
支持WSGI的服務器
    wsgiref
        python自帶的web服務器
    Gunicorn
        用於linux的 python wsgi Http服務器,常用於各種django,flask結合部署服務器。
    mode_wsgi
        實現了Apache與wsgi應用程序的結合
    uWSGI
        C語言開發,快速,自我修復,開發人員友好的WSGI服務器,用於Python Web應用程序的專業部署和開發。

在部署python程序web應用程序時,可以根據性能的需求,選擇合適的wsgi server,不同的wsgi server區別在於並發支持上,有單線程,多進程,多線程,協程的區別,其功能還是近似,無非是請求路由,執行對應的函數,返回處理結果。


Django部署

Django的主要部署平台是 WSGI,這是用於Web服務器和應用程序的Python標准。

Django的 startproject管理命令設置一個簡單的默認WSGI配置,可以根據需要為您的項目進行調整,並指示任何符合WSGI的應用程序服務器使用。

application 
使用WSGI部署的關鍵概念是應用程序服務器用於與代碼通信的 application 可調用。它通常在服務器可訪問的Python模塊中作為名為 application 的對象提供。

startproject 命令創建包含這樣的 application 可調用的文件 <project_name>/wsgi.py. ,它被Django的開發服務器和生產WSGI部署使用。
WSGI服務器從其配置中獲取 application 可調用的路徑。 Django的內置服務器,即 runserver 命令,從 WSGI_APPLICATION 設置讀取它。
1 首先nginx 是對外的服務接口,外部瀏覽器通過url訪問nginx,

2nginx 接收到瀏覽器發送過來的http請求,將包進行解析,分析url,如果是靜態文件請求就直接訪問用戶給nginx配置的靜態文件目錄,直接返回用戶請求的靜態文件,

如果不是靜態文件,而是一個動態的請求,那么nginx就將請求轉發給uwsgi,uwsgi 接收到請求之后將包進行處理,處理成wsgi可以接受的格式,並發給wsgi,wsgi 根據請求調用應用程序的某個文件,某個文件的某個函數,最后處理完將返回值再次交給wsgi,wsgi將返回值進行打包,打包成uwsgi能夠接收的格式,uwsgi接收wsgi 發送的請求,並轉發給nginx,nginx最終將返回值返回給瀏覽器。

3要知道第一級的nginx並不是必須的,uwsgi完全可以完成整個的和瀏覽器交互的流程,但是要考慮到某些情況

1 安全問題,程序不能直接被瀏覽器訪問到,而是通過nginx,nginx只開放某個接口,uwsgi本身是內網接口,這樣運維人員在nginx上加上安全性的限制,可以達到保護程序的作用。

2負載均衡問題,一個uwsgi很可能不夠用,即使開了多個work也是不行,畢竟一台機器的cpu和內存都是有限的,有了nginx做代理,一個nginx可以代理多台uwsgi完成uwsgi的負載均衡。

3靜態文件問題,用django或是uwsgi這種東西來負責靜態文件的處理是很浪費的行為,而且他們本身對文件的處理也不如nginx好,所以整個靜態文件的處理都直接由nginx完成,靜態文件的訪問完全不去經過uwsgi以及其后面的東西。

 

nginx官網

http://nginx.org/en/

nginx有關uwsgi模塊介紹

http://nginx.org/en/docs/http/ngx_http_uwsgi_module.html

 

咱們都知道django是一個web框架,方便我們快速開發web程序,http請求的動態數據就是由web框架來提供處理的。

前面也對nginx簡單的介紹了,本文將nginx、WSGI、uwsgi、uWSGI、django這幾個關系梳理一下。

wsgi    全稱web server gateway interface,wsgi不是服務器,也不是python模塊,只是一種協議,描述web server如何和web application通信的規則。
運行在wsgi上的web框架有bottle,flask,django
uwsgi    和wsgi一樣是通信協議,是uWSGI服務器的單獨協議,用於定義傳輸信息的類型
uWSGI    是一個web服務器,實現了WSGI協議,uwsgi協議。a
nginx    web服務器,更加安全,更好的處理處理靜態資源,緩存功能,負載均衡,因此nginx的強勁性能,配合uWSGI服務器會更加安全,性能有保障。
django 高級的python web框架,用於快速開發,解決web開發的大部分麻煩,程序員可以更專注業務邏輯,無須重新造輪子

邏輯圖

web服務器

傳統的c/s架構,請求的過程是
客戶端 > 服務器 
服務器 > 客戶端
服務器就是:1.接收請求 2.處理請求 3.返回響應

web框架層

HTTP的動態數據交給web框架,例如django遵循MTV模式處理請求。
HTTp協議使用url定位資源,urls.py將路由請求交給views視圖處理,然后返回一個結果,完成一次請求。
web框架使用者只需要處理業務的邏輯即可。

如果將一次通信轉化為“對話”的過程

Nginx:hello wsgi,我剛收到一個請求,你准備下然后讓django來處理吧

WSGI:好的nginx,我馬上設置環境變量,然后把請求交給django

Django:謝謝WSGI,我處理完請求馬上給你響應結果

WSGI:好的,我在等着

Django:搞定啦,麻煩wsgi吧響應結果傳遞給nginx

WSGI:太棒了,nginx,響應結果請收好,已經按照要求傳遞給你了

nginx:好滴。我把響應交給用戶。合作愉快

 

Django Nginx+uwsgi 安裝配置

在前面的章節中我們使用 python manage.py runserver 來運行服務器。這只適用測試環境中使用。

正式發布的服務,需要一個可以穩定而持續的服務器。

基礎開發環境配置

yum groupinstall "Development tools"
yum install zlib-devel bzip2-devel pcre-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel

提前安裝好python3環境

virtualenv

請確保你的虛擬環境正常工作
https://www.cnblogs.com/shangping/p/10756217.html

安裝django1.11

pip3 install django==1.11.14
#創建django項目mysite
django-admin startproject mysite
#創建app01
python3 manage.py startapp app01

mysite/settings.py

#settings.py設置
ALLOWED_HOSTS = ['*']
install app01

mysite/urls.py

from app01 import views
urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^hello_django/', views.hello),
]

app01/views.py

from django.shortcuts import render,HttpResponse

# Create your views here.
def hello(request):
    print('request is :',request)
    return HttpResponse('django is ok ')

安裝uWSGI

進入虛擬環境venv,安裝uwsgi
(venv) [root@slave 192.168.11.64 /opt]$pip3 install uwsgi
檢查uwsgi版本
(venv) [root@slave 192.168.11.64 /opt]$uwsgi --version
2.0.17.1
#檢查uwsgi python版本
uwsgi --python-version

運行簡單的uWSGI                  

#test.py
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return [b"Hello World"] # python3

#啟動一個python
uwsgi --http :9000 --wsgi-file test.py   (注意http后面有個空格)
  • http :8000: 使用http協議,端口8000
  • wsgi-file test.py: 加載指定的文件  test.py
 
          

uWsgi熱加載python程序

注意!!!!!!下面的啟動命令必須在切換到項目下執行,否則無效!!!!

在啟動命令后面加上參數 uwsgi --http :9000 --module dj1901.wsgi --py-autoreload=1 (后面參數不重新執行啟動命令,刷新瀏覽器生效)
(dj1901是自己django項目的名字)
.注意,此時你訪問admin發現項目丟失靜態文件,因為uwsgi不解析靜態文件配置
(怎樣收集靜態文件,看下面靜態文件相關配置)
想要收集靜態文件得用nginx,用啟用nginx的時候,http協議已經不能連接uwsgi,啟動得用socket協議
uwsgi --socket :9000 --module dj1901.wsgi --py-autoreload=1
 nginx的絕對啟動路徑    /opt/nginx1-12/sbin/nginx -s reload
 
上面運行django程序相關參數解釋:

#dj1901/wsgi.py 確保找到這個文件
uwsgi --http :9000 --module dj1901.wsgi
  • module dg1901.wsgi: 加載指定的wsgi模塊  (.wsgi指的是wsgi.py  加. 把py 去掉了)

uwsgi配置文件

上面的啟動得在Django項目下,配置這個啟動文件為了在其他目錄下啟動方便,用下面ini命令啟動即可。
uwsgi支持ini、xml等多種配置方式,本文以 ini 為例, 在/etc/目錄下新建uwsgi_nginx.ini,添加如下配置:
注意:等號左右不要空格
[uwsgi]
chdir=/root/Envs/c1902    #django項目所在的絕對路徑
module=c1902.wsgi #項目名字.wsgi ,和上面銜接,用的是相對路徑
home=/root/Envs/venv3 #虛擬環境所在的絕對路
master=true
processes=1
socket=0.0.0.0:9000
vacuum=true
# mysite_uwsgi.ini file
[uwsgi]

# Django-related settings
# the base directory (full path)
chdir           = /opt/mysite
# Django's wsgi file
module          = mysite.wsgi
# the virtualenv (full path)
home            = /opt/venv
# process-related settings
# master
master          = true
# maximum number of worker processes
processes       = 1
# the socket (use the full path to be safe
socket          = 0.0.0.0:8000
# ... with appropriate permissions - may be needed
# chmod-socket    = 664
# clear environment on exit
vacuum          = true
配置詳解

指定配置文件啟動命令

uwsgi --ini  /etc/uwsgi_nginx.ini    (在任何目錄下都可以啟動了)

配置nginx結合uWSGI

配置nginx.conf

 
worker_processes  1;
error_log  logs/error.log;
pid        logs/nginx.pid;
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
    access_log  logs/access.log  main;
    sendfile        on;
    keepalive_timeout  65;

  #nginx反向代理uwsgi
   #nginx自帶ngx_http_uwsgi_module模塊,起到nginx和uwsgi交互作用
#通過uwsgi_pass設置服務器地址和協議,將動態請求轉發給uwsgi處理
  server { 
listen 80;
server_name localhost;
location / {
     include /opt/nginx1-12/conf/uwsgi_params; #(uwsgi官網提供方法) uwsgi_pass 0.0.0.0:9000; #轉發參數,默認80端口轉到uwsgi的9000端口 root html; index index.html index.htm; }
     #nginx處理靜態頁面資源
     location /static { #F12,請求頭里可以看靜態資源走的路徑static,所以需要配置接口
        alias /opt/static/django;  #靜態文件放在哪里,指明路徑  
}
     
#nginx處理媒體資源
     location /media{
        alias /opt/nginx1-12/media;  
         }
error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}
 

配置完啟動nginx

supervisor

supervisor 是基於 python 的任務管理工具,用來自動運行各種后台任務,當然你也能直接利用 nohup 命令使任務自動后台運行,但如果要重啟任務,每次都自己手動 kill 掉任務進程,這樣很繁瑣,而且一旦程序錯誤導致進程退出的話,系統也無法自動重載任務。

這里要配置基於virtualenv的supervisor

由於supervisor在python3下無法使用,因此只能用python2去下載!!!!!!

#注意此時已經退出虛擬環境了!!!!!
yum install python-setuptools
easy_install supervisor
或者 yum install -y epel-release && yum install -y supervisor(上述方法下載不了可以用這個)

通過命令生成supervisor的配支文件

echo_supervisord_conf > /etc/supervisord.conf

然后再/etc/supervisord.conf末尾添加上如下代碼!!!!!! 

supervisord.conf配置文件參數解釋
[program:xx]是被管理的進程配置參數,xx是進程的名稱
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run  ; 程序啟動命令
autostart=true       ; 在supervisord啟動的時候也自動啟動
startsecs=10         ; 啟動10秒后沒有異常退出,就表示進程正常啟動了,默認為1秒
autorestart=true     ; 程序退出后自動重啟,可選值:[unexpected,true,false],默認為unexpected,表示進程意外殺死后才重啟
startretries=3       ; 啟動失敗自動重試次數,默認是3
user=tomcat          ; 用哪個用戶啟動進程,默認是root
priority=999         ; 進程啟動優先級,默認999,值小的優先啟動
redirect_stderr=true ; 把stderr重定向到stdout,默認false
stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小,默認50MB
stdout_logfile_backups = 20   ; stdout 日志文件備份數,默認是10
; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創建目錄(supervisord 會自動創建日志文件)
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false     ;默認為false,進程被殺死時,是否向這個進程組發送stop信號,包括子進程
killasgroup=false     ;默認為false,向進程組發送kill信號,包括子進程
apache

uwsgi

[program:my]
command=/root/Envs/venv1901/bin/uwsgi --ini  /etc/uwsgi_nginx.ini  #這里是結合virtualenv的命令 和supervisor的精髓!!!!
#command= /root/Envs/venv1901/bin/uwsgi --uwsgi 0.0.0.0:8000 --chdir /root/Envs/myjd19 --home=/root/Envs/django14 --module myjd19.wsgi
#--home指的是虛擬環境目錄 --module找到 myjd19/wsgi.py

最后啟動supervisor,完成uWSGI啟動django,nginx反向代理

supervisord -c /etc/supervisord.conf #啟動supervisor
supervisorctl -c /etc/supervisord.conf restart my #重啟my項目
supervisorctl -c /etc/supervisord.conf [start|stop|restart][program|all]

supervisorctl可以進入交互頁面,進行操作簡單


重新加載supervisor

 
一、添加好配置文件后

二、更新新的配置到supervisord    

supervisorctl update
三、重新啟動配置中的所有程序

supervisorctl reload
四、啟動某個進程(program_name=你配置中寫的程序名稱)

supervisorctl start program_name
五、查看正在守候的進程

supervisorctl       (進入交互模式)
六、停止某一進程 (program_name=你配置中寫的程序名稱)

supervisorctl stop program_name
七、重啟某一進程 (program_name=你配置中寫的程序名稱)

supervisorctl restart program_name
八、停止全部進程

supervisorctl stop all
注意:顯示用stop停止掉的進程,用reload或者update都不會自動重啟。
 

 django的靜態文件與nginx配置

django項目下/settings.py文件最后進行配置

第一步:
STATIC_ROOT='/opt/static/django' #nginx.conf配置文件中需要配置相同靜態資源路徑 STATIC_URL = '/static/'

第二步:

配置完之后,切換到項目下,建立一個static目錄,收集靜態資源用,否則報錯!
python3 manage.py collectstatic 

上述的參數STATIC_ROOT用在哪

通過收集所有你使用的靜態文件保存到STATIC_ROOT!

STATIC_ROOT 文件夾 是用來將所有STATICFILES_DIRS中所有文件夾中的文件,以及各app中static中的文件都復制過來
# 把這些文件放到一起是為了用nginx等部署的時候更方便
(django之后會用到,可以了解下)
STATICFILES_DIRS=[
    os.path.join(BASE_DIR,"static"),
]

 

參考文檔:http://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/tutorials/Django_and_nginx.html

 uwsgi熱加載:https://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/Management.html


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM