Django Nginx uWSGI 部署詳細教程

jopen 9年前發布 | 65K 次閱讀 Django Web框架

1. 運行開發服務器測試

cd zqxt # 進入項目 zqxt 目錄
python manage.py runserver

運行開發服務器測試,確保開發服務器下能正常打開網站。

2. 安裝 nginx 和 需要的包

2.1 安裝 nginx 等軟件

ubuntu / Linux Mint 等,下面簡寫為 (ubuntu):

sudo apt-get install python-dev nginx

centos / Fedora/ redhat 等,下面簡寫為 (centos)

sudo yum install epel-release
sudo yum install python-devel nginx

2.2 安裝 supervisor, 一個專門用來管理進程的工具,我們用它來管理 gunicorn/uwsgi

sudo pip install supervisor

Ubuntu用戶 請直接看 3,以下是CentOS 注意事項:

CentOS下,如果不是非常懂 SELinux 和 iptables 的話,為了方便調試,可以先臨時關閉它們,如果發現部署了之后出不來結果,可以臨時關閉測試一下,這樣就知道是不是 SELinux 和 iptables 的問題

CentOS 7 iptables如何使用http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7


將 SELinux 設置為寬容模式,方便調試:

sudo setenforce 0

防火墻相關的設置:

可以選擇臨時關閉防火墻
sudo service iptables stop

或者開放一些需要的端口,比如 80
sudo iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT

上面的兩條命令,如果是 CentOS 7 用

臨時關閉防火墻
sudo systemctl stop firewalld

或者 開放需要的端口
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload

備注:由于我還沒有用 最新版本的 Fedora ,需要用 dnf 來安裝包,有需求的同學自測,可以參考這里

3. 使用 gunicorn / uwsgi 來部署 (二選一)

注意:以下為二選一,不需要兩個都用

3.1 使用 gunicorn(純Python實現的包):

sudo pip install gunicorn

在項目目錄下運行下面的命令進行測試:

gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi

-w 表示開啟多少個worker,-b 表示要使用的ip和port,我們這里用的是 8001,0.0.0.0代表監控電腦的所有 ip。


如果使用了 virtualenv 可以這樣

/path/to/env/bin/gunicorn --chdir /path/to/project --pythonpath /path/to/env/ -w4 -b0.0.0.0:8017 project.wsgi:application

用 --pythonpath 指定依賴包路徑,多個的時候用逗號,隔開,如:'/path/to/lib,/home/tu/lib'

3.2 使用 uwsgi(純C語言實現的包):

安裝 uwsgi

sudo pip install uwsgi

使用 uwsgi 運行項目

uwsgi --http :8001 --chdir /path/to/project --home=/path/to/env --module project.wsgi

這樣就可以跑了,--home 指定virtualenv 路徑,如果沒有可以去掉。project.wsgi 指 project/wsgi.py 文件

如果提示端口已經被占用:

probably another instance of uWSGI is running on the same address (:8002).
bind(): Address already in use [core/socket.c line 764]

這時可以把相關的進程 kill 掉:

按照端口進行查詢:

lsof -i :8002

可以查出:

COMMAND  PID USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
uwsgi   2208   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN)
uwsgi   2209   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN)

這時根據 PID 可以用下面的命令 kill 掉相關程序:

sudo kill -9 2208 2209

按照程序名稱查詢:

ps aux | grep uwsgi

4. 使用supervisor來管理進程

生成 supervisor 默認配置文件,比如我們放在 /etc/supervisord.conf 路徑中:

sudo echo_supervisord_conf > /etc/supervisord.conf

打開 supervisor.conf 在最底部添加:

[program:zqxt]
 command=/path/to/uwsgi --http :8003 --chdir /path/to/zqxt --module zqxt.wsgi
 directory=/path/to/zqxt
 startsecs=0
 stopwaitsecs=0
 autostart=true
 autorestart=true

command 中寫上對應的命令,這樣,就可以用 supervisor 來管理了

supervisord -c /etc/supervisord.conf

重啟 zqxt 程序(項目):

supervisorctl -c /etc/supervisord.conf restart zqxt

啟動,停止,或重啟 supervisor 管理的某個程序 或 所有程序:

supervisorctl -c /etc/supervisord.conf [start|stop|restart] [program-name|all]

以 uwsgi 為例,上面這樣使用一行命令太長了,我們使用 ini 配置文件來搞定,比如項目在 /home/tu/zqxt 這個位置,

在其中新建一個 uwsgi.ini 全路徑為 /path/to/project/uwsgi.ini

 [uwsgi]
 chdir=/path/to/project
 module=zqxt.wsgi:application
 socket = /tmp/zqxt.sock
 master=True
 pidfile=/tmp/zqxt-master.pid
 vacuum=True
 max-requests=5000
 daemonize=/path/to/project/zqxt.log

注意上面的 /tmp/zqxt.sock ,一會兒我們把它和 nginx 關聯起來。

修改 supervisor 配置文件中的 command 一行:

[program:zqxt]
 command=/path/to/uwsgi --ini /path/to/project/uwsgi.ini
 directory=/path/to/zqxt
 startsecs=0

然后重啟一下 supervisor:

supervisorctl -c /etc/supervisord.conf restart zqxt
或者 supervisorctl -c /etc/supervisord.conf restart all

5. 配置 nginx

新建一個網站 zqxt

sudo vim /etc/nginx/sites-available/zqxt.conf

寫入以下內容:

upstream zqxt_uwsgi {
    server unix:///tmp/zqxt.sock;
}

server {
    listen      80;
    server_name www.ziqiangxuetang.com;
    charset     utf-8;

    client_max_body_size 75M;

    location /media  {
        alias /path/to/project/media;
    }

    location /static {
        alias /path/to/project/static;
    }

    location / {
        uwsgi_pass  zqxt_uwsgi;
        include     /etc/nginx/uwsgi_params;
    }
}

激活網站:

sudo ln -s /etc/nginx/sites-available/zqxt.conf /etc/nginx/sites-enabled/zqxt.conf

重啟 nginx 服務器:

sudo service nginx reload
或者 sudo service nginx restart


一些有用的參考教程:

Django 官網部署教程:

https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/gunicorn/

https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/uwsgi/


一些博客相關教程:

http://www.ituring.com.cn/article/201045

http://www.jianshu.com/p/be9dd421fb8d

http://blog.csdn.net/tengzhaorong/article/details/12833157


nginx 與 socket

http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configure-nginx-for-your-site


防火墻:

iptables: https://www.digitalocean.com/community/tutorials/how-to-setup-a-basic-ip-tables-configuration-on-centos-6

centos 7 FireWalld: http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7

ubuntu ufw 防火墻:http://wiki.ubuntu.org.cn/Ufw%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97


uwsgi ini 配置文件:http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file

來自:http://www.ziqiangxuetang.com/django/django-nginx-deploy.html

 本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
 轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!