Nginx+uWSGI+Django環境配置

一般項目會部署在虛擬環境，虛擬環境的使用能夠參考這裏，點擊前往

固然你也能夠直接部署，這裏很少說。

1、安裝uWSGI

1.經過pip安裝

pip install uwsgi

這裏只說明瞭一種安裝方式，其餘安裝方式能夠參考官網，點擊跳轉。

2、第一個WSGI程序

# 建立一個名爲test.py 的文件

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

# 在HTTP端口9090上進行部署

uwsgi --http：8000 --wsgi-file test.py

選項說明：

• --http : 使用協議http,端口9090
• --wsgi-file test.py : 加載指定的文件test.py

如今再去訪問，我這裏的地址爲http://192.168.10.165:8000/就能夠看到Hello World 信息

若是是這樣，工做流程爲      網絡客戶端 <--> uWSGI <--> Python

3、添加併發和查看uwsgi狀態

每個處於監聽(Listen)狀態的端口,都有本身的監聽隊列.監聽隊列的長度,與以下兩方面有關:

somaxconn參數和使用該端口的程序中listen()函數

能夠經過echo 1000 >/proc/sys/net/core/somaxconn 命令來修改系統的監聽隊列長度。而且在/etc/sysctl.conf文件中添加net.core.somaxconn = 1024 並sysctl -p生效。

經過 添加--listen num參數增長隊列長度。

默認狀況下，uWSGI以單進場和單線程開始的，你可使用--processes添加更多的進程，--threads添加更多的線程

uwsgi --http :9090 --wsgi-file test.py --master --processes 4 --threads 2

查看uwsgi狀態：

    統計子系統容許將uWSGI的內部統計信息導出爲JSON

uwsgi --http :9090 --wsgi-file test.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

請求您的應用程序，而後Telnet到端口9191，你會獲得不少關係uwsgi的相關信息。

使用「uwsgitop」工具能夠來監控實例

　　須要使用pip install uwsgitop 來安裝uwsgitop

注意:將統計套接字綁定到私人地址（除非你知道你在作什麼），不然每一個人均可以訪問它！

uwsgi的使用還有其餘不少的選項，查看更多點擊這裏。

4、uwsgi + Django配置

如今咱們但願uWSGI作一樣的事情，可是運行Django站點而不是test.py 模塊。

首先咱們來建立一個django 站點，並啓動測試該站點是否能夠正常訪問：

source bin/activate        # 進去python虛擬環境
pip install django    # 安裝django
django-admin startproject mysite    # 新建站點
cd mysite/    
vim mysite/settings.py    # 配置ALLOWED_HOSTS爲‘["*"]’，方便其餘主機訪問站點，也能夠不修改
python manage.py runserver 0.0.0.0:8000    # 啓動並測試可用性

在測試站點能夠正常運行後，關閉站點，下面來使用uwsgi來運行django項目:

uwsgi --http :8000 --module mysite.wsgi

• --module mysite.wsgi : 加載指定的wsgi模塊
• --http : add an http router/server on the specified address
• --socket: bind to the specified UNIX/TCP socket using default protocol

經過瀏覽器訪問頁面，若是頁面出現，意味着uWSGI可以從你的virtualenv服務於你的django項目，而且正常運行，此時的工做流程爲：

網絡客戶端 <--> uWSGI <--> Django

注意：

　　此時若是你的django須要訪問靜態文件，是訪問不到的，須要利用uWSGI進行靜態文件的配置，這裏不做說明，由於通常也不須要uWSGI來處理站點的靜態文件，

　　通常使用網絡服務器來處理這些靜態文件會更好，更高效。

一般不會讓瀏覽器直接與uWSIG會話，這個是網絡服務器的工做（這裏爲Nginx）,uWSGI將做爲一箇中間件。

5、Nginx環境和靜態文件配置

1.首先搭建Nginx環境

yum install nginx
/etc/init.d/nginx start    # start nginx

nginx的配置問題這裏不過多說明，避免與默認配置衝突，我選擇新建vhost文件夾，在vhost下添加配置，而後導入到主配置文件中，這裏使用8000端口。

新建一個Nginx的配置（mysite_nginx.conf）放入vhost中：（記得在Nginx主配置文件中導入該配置）

# mysite_nginx.conf

# the upstream component nginx needs to connect to
upstream django {
    # server unix:///path/to/your/mysite/mysite.sock; # for a file socket
    server 127.0.0.1:8001; # for a web port socket (we'll use this first)
}

# configuration of the server
server {
    # the port your site will be served on
    listen      8000;
    # the domain name it will serve for
    server_name .example.com; # substitute your machine's IP address or FQDN
    charset     utf-8;

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

    # Django media
    location /media  {
        alias /path/to/your/mysite/media;  # your Django project's media files - amend as required
    }

    location /static {
        alias /path/to/your/mysite/static; # your Django project's static files - amend as required
    }

    # Finally, send all non-media requests to the Django server.
    location / {
        uwsgi_pass  django;
        include     /path/to/your/mysite/uwsgi_params; # the uwsgi_params file you installed
    }
}
# 這裏的配置須要進行修改，路徑爲你項目路徑

這個conf文件告訴nginx從文件系統提供媒體和靜態文件，以及處理須要Django干預的請求。對於大型部署來講，讓一臺服務器處理靜態/媒體文件以及另外一個處理Django應用程序的

作法被認爲是很好的作法，可是如今這樣作會很好。

爲了方便對文件的查看和修改，建議把配置文件創建一個軟鏈接到項目目錄下。

sudo ln -s  /etc/nginx/sites-enabled/mysite_nginx.conf /path/to/your/mysite/

2.部署靜態文件

在運行Nginx以前，必須在靜態文件夾中收集全部的django靜態文件，須要編輯mysite/settings.py 添加：

STATIC_ROOT = os.path.join(BASE_DIR, "static/")
# and then run
python manage.py collectstatic

這裏須要注意一點，配置的靜態文件夾和django的靜態文件夾不能爲一個。

3.檢查靜態文件配置

在啓動Nginx是會報錯，那是由於配置文件在的  include /path/to/your/mysite/uwsgi_params;

須要導入這個文件， 這個文件通常在Nginx uwsgi發行版的目錄中，或從這裏獲取https://github.com/nginx/nginx/blob/master/conf/uwsgi_params

啓動後檢查是否能夠獲取靜態文件。

6、Nginx + uWSGI + test.py

1.使用uWSGI啓動一個socket ,使nginx能夠轉發到uWSGI

uwsgi --socket：8001 --wsgi-file test.py

• socket：8001 ： 使用協議uwsgi,端口8001

nginx同時被配置爲與該WSGI在該端口上通訊，並與外界在8000端口進行通訊

這是當前的堆棧：

web客戶端 <--> web服務器 <--> 套接字 <--> uWSGI <--> pyhton(test.py)

2.使用Unix套接字實現

編輯mysite_nginx.conf，使用套接字來實現：

server unix:///path/to/your/mysite/mysite.sock; # for a file socket
# server 127.0.0.1:8001; # for a web port socket (we'll use this first)

這個socket選項告訴uWSGI使用哪一個文件進行套接字鏈接。

若是不行：

　　檢查Nginx錯誤日誌 nginx/error.log 若是你看到 

connect() to unix:///path/to/your/mysite/mysite.sock failed (13: Permissiondenied)

那麼可能你須要管理套接字的權限，以便運行nginx使用它。

uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=666 # (verypermissive)
uwsgi --socket mysite.sock --wsgi-file test.py --chmod-socket=664 # (moresensible)

你可能還須要將用戶添加到nginx的組裏，以便nginx能夠正確的讀取和寫入套接字

7、Nginx + uWSGI + Django

來運行咱們的Django應用程序：

uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=664  # 或者是666

如今uWSGI和nginx不只僅是一個「Hello World 」 ,而是個Django項目。

經過ini配置文件運行uWSGI

uwsgi支持經過各類的配置文件來啓動服務，這裏說一個ini配置文件

建立一個名爲mysite_uwsgi.ini：

# mysite_uwsgi.ini file
[uwsgi]

# Django-related settings
# the base directory (full path)
chdir           = /path/to/your/project
# Django's wsgi file
module          = project.wsgi
# the virtualenv (full path)
home            = /path/to/virtualenv

# process-related settings
# master
master          = true
# maximum number of worker processes
processes       = 10
# the socket (use the full path to be safe
socket          = /path/to/your/project/mysite.sock
# ... with appropriate permissions - may be needed
# chmod-socket    = 664  # 或者666
# clear environment on exit
vacuum          = true

並運行uwsgi:

uwsgi --ini mysite_uwsgi.ini # the --ini option is used to specify a file

測試站點是否正常，成功。。

退出Python虛擬環境使用：

deactivate

8、皇帝模式來管理uWSGI

uWSGI能夠運行在'皇帝'模式。在這種模式下，它會關注uWSGI配置文件的目錄，併爲每一個配置文件生成一個實例（'vassals'）。

每當修改配置文件時，皇帝將自動從新啓動附庸。

# create a directory for the vassals
sudo mkdir /etc/uwsgi
sudo mkdir /etc/uwsgi/vassals
# symlink from the default config directory to your config file
sudo ln -s /path/to/your/mysite/mysite_uwsgi.ini /etc/uwsgi/vassals/
# run the emperor
uwsgi --emperor /etc/uwsgi/vassals --uid nginx --gid nginx

• emperor：在哪裏尋找附庸（配置文件）
• uid：進程一旦啓動的用戶ID
• gid：進程一旦啓動的組ID

9、其餘

這裏