Django 项目部署

Django 项目部署

1. 概述

将开发完成的 Django 项目部署到指定的服务器上，而服务器的系统基本都是 linux。

Django 项目当前最主要的部署方式是：Python+Django+Nginx+uWSGI

• python：是 python 程序运行的环境
• Django：是项目开发的主要框架，也特指我们开发的 django 项目
• Nginx：反向代理服务器，用于实现对用户请求的转发，转发给 uWSGI，主要实现 3 个功能：
  • 反向代理
  • 动静分离
  • 负载均衡
• uWSGI：python 的 web 服务器，使用 WSGI 协议和 django 项目交互，使用 uwsgi 协议和 nginx 进行通信

2.Django 项目处理

前提是已经开发完毕的项目

在 settings.py 修改

# 修改通用配置
DEBUG = False

ALLOWED_HOSTS = ['*']

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'deploy_study',
        'USER': 'root',
        'PASSWORD': '123456',
        'HOST': '192.168.134.1',
        'PORT': '3306',
    }
}
# 静态文件处理
# url中访问静态文件的url起始path
STATIC_URL = '/static/'

# 合并后的静态文件目录的绝对路径，需要在根目录添加 static 目录
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

# 以下不是必须的， 扩展的静态文件地址，需要添加 common_static 目录
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, 'common_static'),
)

说明：

• 修改 DEBUG 为 False，同时必须配置 ALLOWED_HOSTS ，内容是允许访问的域名列表，使用 * 表示通配符
• 修改数据库连接为 生产环境 下使用的
• 主要需要添加 STATIC_ROOT 配置，用于部署后，合并各个子应用下的静态文件
• 部署后，别忘记使用 python manage.py collectstatic命令，合并各个子应用下的静态文件，然后在 处理静态文件的服务器中（如 nginx）配置到该路径

python 环境处理

在 django 项目的根目录，生成一个 requirements.txt

# 如果使用的第三方库比较少，那么可以手写一个 requirements.txt
# 如果使用的第三方库较多，那么就使用以下命令：
pip freeze > requirements.txt

# 拷贝上述的文件到服务器中，并且执行以下命令安装环境
pip3 install -r requirements.txt

复制项目文件到服务器

将项目拷贝 linux 系统中（譬如 FTP），然后移动到 /var/www/ 目录下

mv /ftp/childrenshop /var/www/

PS：拷贝完成后，记得执行合并 static 的命令python manage.py collectstatic

安装和使用 uWSGI

1、 uwsgi 官方文档

2、 在生产环境中，使用虚拟环境，一般我们的 linux 中，会有 2 套 python，一个是系统自带的 python2，一个是我们的项目环境所需的 python3

# 使用以下命令查看
python2 -V
python3 -V

3、 在环境中安装项目所需第三方库，假定当前 djang 项目（项目名：childrenshop）已经拷贝到 /var/www 目录下，并且目录中已经有 requirements.txt 文件

# 切换到 项目路径
cd /var/www/children

# 安装环境
pip3 install -r requirements.txt -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

4、 使用 pip 安装 uwsgi

pip3 install uwsgi==2.0.18 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

• -i ： 指定镜像源的网址，这里使用的豆瓣
• –trusted-host ： 信任 -i 指定的网站，不进行信任的话，会出现 SSL 错误

5、测试 uwsgi

编写一个测试的 py 文件

vi test.py

文件内容如下：

#!/usr/bin/env python3
# coding:utf-8

import sys

def application(env,start_response):
    start_response('200 OK',[('Content-Type','text/html')])
    return 'Welcome to use uwsgi!!!'.encode()

运行：

/usr/local/python36/bin/uwsgi --http 0.0.0.0:8997 --wsgi-f /var/www/childrenshop/test.py

注意：

由于我们需要从本机访问 linux 的 8997 端口，因此需要设置 linux 的防火墙：

# 开放8997端口
firewall-cmd --zone=public --add-port=8997/tcp --permanent

# 删除端口
firewall-cmd --zone=public --remove-port=8997/tcp

# 重启防火墙
firewall-cmd --reload

# 查看防火墙状态
firewall-cmd --list-all

在浏览器中，访问： http://192.168.134.101:8997 ，注意修改对应的 ip 地址

即可查看到类似如下页面中显示：

Welcome to use uwsgi!!!

6、 使用 uwsgi 启动 django：

使用 ini 格式配置文件，文件名 uwsgi.ini ：

vi uwsgi.ini

文件内容：

[uwsgi]
# 虚拟主机模式
vhost = false
# ip端口
socket = 0.0.0.0:8997
# 是否主服务器
master = true
# 是否多线程
enable-threads = true
# 工作进程数
workers = 5
# wsgi文件的位置
wsgi-file = /var/www/childrenshop/childrenshop/wsgi.py
# 项目的根目录
chdir = /var/www/childrenshop/

# 设置 pid 记录文件
pidfile = /var/run/uwsgi.pid
# 后台运行uwsgi, 如果想实时查看日志内容，可以使用 tail -f uwsgi.log
daemonize = /var/www/childrenshop/logs/uwsgi.log

说明：

• daemonize 指定 log 输出， 需要创建对应的 目录
• 如果是想要通过浏览器访问的话，需要将配置中的 socket = 修改为 http = ，否则会报以下错误：

invalid request block size: 21573 (max 4096)...skip

同时需要在防火墙中开放 8997 端口，如果上面已经开放过了，就不需要再额外处理

启动 uwsgi：

/usr/local/python36/bin/uwsgi --ini /var/www/childrenshop/uwsgi.ini

也可以先创建链接，再运行：

ln /usr/local/python36/bin/uwsgi /usr/bin/uwsgi

uwsgi --ini /var/www/childrenshop/uwsgi.ini

如果不以后台模式启动，会得到如下界面：

备注：

如果需要使用 killall 命令关闭所有的 uwsgi 进程的话，需要安装库：

yum install -y psmisc

安装完毕后，可以使用以下命令关闭 uwsgi 进程

killall -9 uwsgi

7、设置启动脚本，service 方式

在/etc/init.d/ 目录下建立 3 个脚本：

uwsgi-start.sh

#!/bin/bash -e

export LD_LIBRARY_PATH="/usr/local/lib"

/usr/local/python36/bin/uwsgi --ini /var/www/childrenshop/uwsgi.ini

说明： export LD_LIBRARY_PATH=“/usr/local/lib” 这一行是为了防止 出现 sqlite 版本错误

uwsgi-stop.sh

#!/bin/bash -e

/usr/local/python36/bin/uwsgi --stop /var/run/uwsgi.pid

说明：/var/run/uwsgi.pid 是在 uwsgi.ini 中配置的

uwsgi-restart.sh

#!/bin/bash -e

/usr/local/python36/bin/uwsgi --reload /var/run/uwsgi.pid

脚本赋予权限：

chmod 755 uwsgi-start.sh
chmod 755 uwsgi-stop.sh
chmod 755 uwsgi-restart.sh

编写 service 脚本：

vi /usr/lib/systemd/system/uwsgi.service

填入以下内容：

[Unit]
Description=uwsgi
After=network.target

[Service]
Type=forking
PIDFile=/var/run/uwsgi.pid
ExecStart=/etc/init.d/uwsgi-start.sh
ExecReload=/etc/init.d/uwsgi-restart.sh
ExecStop=/etc/init.d/uwsgi-stop.sh
PrivateTmp=true

[Install]
WantedBy=multi-user.target

说明：

• 以上出现的路径必须是绝对路径
• ExecStart、ExecReload、ExecStop 3 个分别对应 启动、重新启动、停止
• PIDFile 对应启动后的 pid 保存文件

设置自启动

systemctl enable uwsgi.service

说明： .service 可以省略

# 启动
systemctl start uwsgi

# 停止
systemctl stop uwsgi

# 重启
systemctl restart uwsgi
[Install]
WantedBy=multi-user.target

说明：

• 以上出现的路径必须是绝对路径
• ExecStart、ExecReload、ExecStop 3 个分别对应 启动、重新启动、停止
• PIDFile 对应启动后的 pid 保存文件

设置自启动

systemctl enable uwsgi.service

说明： .service 可以省略

# 启动
systemctl start uwsgi

# 停止
systemctl stop uwsgi

# 重启
systemctl restart uwsgi