nginx+django線上部署

（一）：背景在線

由於現在工作的需要，我需要使用Python來進行一個網站后台的開發，python之前接觸過其語法的學習，基本的東西已經掌握，但是當時自學的時候是學得python3.5，而現在要使用python2.7進行實現，所以，先不管了，大多是一樣的，有部分是不一樣的，慢慢搞吧．

（二）：編程環境搭建

我的網站開發是在ubuntu系統下進行的，我們都知道，ubuntu系統在安裝的時候，是自帶python2.7的，所以，pyhthon就不用進行安裝了．我們還需要安裝的有：

• django ‘1.6.0’
• mysql 5.6
• ngix

好了，下面我們就搭建我們的環境．

（１）：安裝Django

首先我們需要安裝的是django，我們直接使用命令進行安裝：

sudo apt-get install python-django

 

安裝完成之后，我們來測試一下我們的django的版本．使用下面的命令:

python
import django
django.get_version()

 

下面來看一下我的系統的輸出：

（２）：安裝MySQL

Django安裝完成之后，接着我們需要安裝與他進行合作網站開發的mysql．在ubuntu中安裝mysql比較簡單，直接使用命令行即可安裝，在這里我們使用mysql5.6

sudo apt-get install mysql-server

 

在安裝中間，他會提示你讓你輸入root用戶的密碼，這個密碼要記住．

安裝完成后，我們測試一下打開我們的數據庫摟一眼．

mysql -u root -p 
//回車之后，輸入密碼

能夠進入之后，就表明我們的數據庫安裝完成了．

（３）：安裝Django和mysql連接的驅動

當安裝完成Django和Mysql之后，如果想要Django能夠找到mysql，我們就需要安裝一個驅動，這樣來安裝：

sudo apt-get install python-mysqldb 

　　

安裝完成之后，就表明我們的變成環境就搭建完成了，現在ngix暫時使用不到，所以我們后面再講述如何安裝ngix．

（三）：Hello World

１：新建項目

首先我們需要將工作路徑切換到我們希望建工程的目錄下：

cd xxxx

 

然后，在該目錄下執行下面的命令：

django-admin startproject HelloWorld

 

新建app:

python manage.py startapp app名稱

　　

這里的HelloWorld就是我們項目的名稱．下面我們來看一下新建項目的目錄結構．

下面來介紹一下各個目錄和文件的作用．

HelloWorld: 項目的容器 
manage.py: 命令行工具，用於和Django交互 
HelloWorld/init.py:空文件，告訴python，該目錄是一個Python包 
HelloWorld/setting.py : 對該項目的配置文件 
HelloWorld/urls.py : 該項目的url聲明 
HelloWorld/wsgi.py : 服務器入口

２：運行服務器

當我們的項目新建完成之后，我們就需要測試一下該項目有沒有創建成功，也就是能不能運行起來．

python manage.py runserver

　　

３：瀏覽器運行測試

當我們的服務器啟動成功之后，我們就在我們的瀏覽器中輸入http://127.0.0.1:8000，下面我們來看一下運行成功后的瀏覽器輸出．

如果你的輸出是這樣的，那么你就成功了．

４：重新部署

當我們修改了代碼之后，服務器會自動檢測其代碼的改變，所以，不需要重新啟動服務器了．

 

nginx:

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安裝方法：

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

 

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

sudo pip install supervisor

　　

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

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

CentOS 7 iptables如何使用：http://stackoverflow.com/questions/24756240/

將 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

　　

3. 使用 uwsgi 來部署備注：由於我還沒有用 最新版本的 Fedora ，新版 Fedora 需要用 dnf 來安裝包，有需求的同學自測，可以參考這里。

安裝 uwsgi

sudo pip install uwsgi --upgrade

 

使用 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

　　

補充內容：

使用 gunicorn 代替 uwsgi 的方法

sudo pip install gunicorn
 
在項目目錄下運行下面的命令進行測試：
gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi

　　

如果使用了 virtualenv 可以這樣-w 表示開啟多少個worker，-b 表示要使用的ip和port，我們這里用的是 8001，0.0.0.0代表監控電腦的所有 ip。

/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'

4. 使用supervisor來管理進程

安裝 supervisor 軟件包

(sudo) pip install 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 來管理了。

啟動 supervisor

(sudo) supervisord -c /etc/supervisord.conf

 

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

(sudo) supervisorctl -c /etc/supervisord.conf restart zqxt

　　

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

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

　　

在其中新建一個 uwsgi.ini 全路徑為 /home/tu/zqxt/uwsgi.ini

[uwsgi]
socket = /home/tu/zqxt/zqxt.sock
chdir = /home/tu/zqxt
wsgi-file = zqxt/wsgi.py
touch-reload = /home/tu/zqxt/reload
 
processes = 2
threads = 4
 
chmod-socket = 664
chown-socket = tu:www-data
 
vacuum = true

在項目上新建一個空白的 reload 文件，只要 touch 一下這個文件（touch reload) 項目就會重啟。注意上面的 /home/tu/zqxt/zqxt.sock ，一會兒我們把它和 nginx 關聯起來。

注意：不建議把 sock 文件放在 /tmp 下，比如 /tmp/xxx.sock (不建議)！有些系統的臨時文件是 namespaced 的，進程只能看到自己的臨時文件，導致 nginx 找不到 uwsgi 的 socket 文件，訪問時顯示502，nginx 的 access log 中顯示 unix: /tmp/xxx.sock failed (2: No such file or directory)，所以部署的時候建議用其它目錄來放 socket 文件，比如放在運行nginx用戶目錄中，也可以專門弄一個目錄來存放 sock 文件，比如 /tmp2/

sudo mkdir -p /tmp2/ && sudo chmod 777 /tmp2/
#然后可以用 /tmp2/zqxt.sock 這樣的路徑了

 詳細參考 http://stackoverflow.com/questions/32974204/got-no-such-file-or-directory-error-while-configuring-nginx-and-uwsgi

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

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

　

然后重啟一下 supervisor：

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

　　

5. 配置 Nginx

新建一個網站 zqxt

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

　　

寫入以下內容：

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  unix:///home/tu/zqxt/zqxt.sock;
        include     /etc/nginx/uwsgi_params;
    }
}

　　

激活網站：

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

　　

測試配置語法問題

sudo service nginx configtest 或 /path/to/nginx -t

　　

重啟 nginx 服務器：

sudo service nginx configtest 或 /path/to/nginx -t

　　

一些有用的參考教程： 

Django 官網部署教程：

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

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

 

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