Django作为最受欢迎基于Python的Web框架之一,为用户提供了一个轻量级的测试Server,但这个Server最好不要用于生产环境。那么如果我们需要在生产环境上面部署Django项目,那么我们使用什么环境呢?最早Django推荐使用Apache+mod_wsgi,但现在已经Django的部署方法已对有很多,越来越好,也相对更复杂了,本文将介绍其中一种Django在生产环境的部署方案:Gunicorn+Nginx+Supervisor


实验环境:

  • 操作系统:CentOS 7

  • Python版本:3.4.8

  • Django版本:2.0.5


准备实验环境:

    因为CentOS 7默认的Python版本为2.7.5,所以我们需要再安装一个3.4.8的版本。另外我们使用的Django版本为2.0.5,Django 2.x版本只支持Python 3.x的版本,所以我们第一步先安装3.x版本的Python

yum install python34 python34-pip

接下来再安装Django

#  此命令表示使用3.4版本的Python来安装Django,如果直接使用pip install django,默认是使用2.7.5的Python,这样会提示不支持,无法安装
python3.4 -m pip install django

安装Gunicorn

python3.4 -m pip install gunicorn

安装Nginx

yum install nginx

安装Supervisor

yum install supervisor


创建Django项目:

# 注意替换ProJectName为自己的项目名,AppName为自己的App名
django-admin startproject ProJectName
cd ProJectName
django-admin startapp AppName


使用Gunicorn测试启动Django项目:

# 必须进入到项目的目录再执行下面的命令
cd ProJectName
gunicorn ProJectName.wsgi

启动成功后输入大概如下

[2018-05-24 09:50:33 +0800] [22849] [INFO] Starting gunicorn 19.8.1
[2018-05-24 09:50:33 +0800] [22849] [INFO] Listening at: http://127.0.0.1:8000 (22849)
[2018-05-24 09:50:33 +0800] [22849] [INFO] Using worker: sync
[2018-05-24 09:50:33 +0800] [22852] [INFO] Booting worker with pid: 22852

从以上信息我们可以看出项目已经启动成功,gunicron版本为19.8.1,监听127.0.0.1:8000端口并且工作在22849号进程,启动的worker方式为sync,并启动了一个worker进程,进程号为22852。更多关于workder相关的资料自行查略更多的信息

由上面我们监听在127.0.0.1,我们客户端无法访问,所以我们需要指定监听端口启动,把上面的直接Ctrl+c结束,然后执行下面的命令启动

# 使用-b指定监听的地址和端口
gunicorn Gogenius.wsgi -b 0.0.0.0:8000


配置Supervisor:

    Supervisor主要是用来管理进程的工具,默认安装好了以后有一个配置文件/etc/supervisord.conf,这是主配置文件。还有一个目录/etc/supervisord.d,这个目录一般用来存放我们管理的进程,每个进程一个配置文件,以.ini结尾

创建一个管理Gunicorn的配置文件

touch /etc/supervisord.d/gunicorn.ini

gunicorn.conf的内容为

[program:gunicorn]
directory= /usr/local/ProJectName
command = /usr/bin/gunicorn ProJectName.wsgi -b 127.0.0.1:8000
user = root
autostart= true
autorestart= true
redirect_stderr = true
stdout_logfile = /var/log/gunicorn.log

说明:

  • [program:gunicorn]:其中gunicorn为要管理的子进程名称,此名称可以自定义,但最好不要乱写,与子进程有点关系为好

  • directory:Django项目的根目

  • command:要执行的命令,这里为启动子进程的命令,子进程为gunicorn

  • user:指定启动子进程的用户

  • autostart :自动启动,也就是当父亲进程启动的时候,子进程也跟随启动。supervisor为父进程

  • autorestart:自动重启,也就是当子进程挂掉的时候,父进程将会尝试自动去重启了进程

  • redirect_stderr:当此选项为true的时候,错误日志也会写进stdout_logfile中

  • stdout_logfile:定义stdout_logfile路径

关于更多资料可以参考此链接

接下来就是启动Supervisor

systemctl start supervisord.service
systemctl enable supervisord.service

如果更改过子进程的配置文件,这时候我们只需要reload下我们的Supervisor服务即可,不需要重启整个服务,这样会影响其它的服务

supervisorctl reload


配置Nginx转发:

     我们知道我们Django本身就可以作用一个轻量级的Web Server,Django里面为我们定义了我们html js img css等页面的存放位置,并且为自动的去找到需要的页面。但现在我们没有使用Django本身的Web Server,这时候就需要通过我们Nginx配置代理来让客户端请求访问到对应的页面,Nginx配置如下:根据自己需求

server {

    listen 5000;

    location / {
        # proxy_pass指定地址为访问gunicorn地址和端口
        proxy_pass http://127.0.0.1:8000;
        proxy_next_upstream http_500 http_502 http_503 error timeout invalid_header;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
    }

    location ~.*\.(html|css|js|jpg|json|png|map|\ttf*|\woff2*|\woff*|eot|otf|ttf|json|cur|woff|svg|woff2|m3u8|ts|mp3)$ {
        # root指定Django项目的根目录
        root /usr/local/Gogenius;
        proxy_next_upstream http_500 http_502 http_503 error timeout invalid_header;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

启动Nginx

systemctl start nginx
systemctl enable nginx

至此,我们就可以通过Nginx的5000端口访问我们的Django项目了