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