使用WSGI部署Django的几种方式

部署服务器介绍:

  • Gunicorn ('Green Unicorn') 是一个 UNIX 下的纯 Python WSGI 服务器
  • uWSGI 是一个快速的,自我驱动的,对开发者和系统管理员友好的应用容器服务器,完全由 C 编写
  • Apache 和 mod_wsgi 在生产环境部署已经过充分测试

方式一:使用 Gunicorn 托管 Django

安装 Gunicorn

> pip install gunicorn

把 Django 当作普通 WSGI 应用在 Gunicorn 中运行

安装了 Gunicorn 后,将提供一个 gunicorn 命令,该命令用于启动 Gunicorn 服务器进程。最简单的使用方式是传递包含名为 application 的 WSGI 应用程序对象的模块的位置,对于典型的 Django 项目,如下所示:

> gunicorn myproject.wsgi

这样会创建一个进程,包含了一个监听在 127.0.0.1:8000 的线程。前提是你的项目在 Python path 中,要满足这个条件,最简单的方法是在 manage.py 文件所在的目录中运行这条命令。

方式二:使用 uWSGI 托管 Django

uWSGI 文档提供了一个覆盖 Django,nginx,和 uWSGI(一个配置,多种适配)。以下文档专注于如何用 uWSGI 集成 Django。

前置条件:uWSGI

安装uwsgi

pip install uwsgi

配置并启动用于 Django 的 uWSGI 服务器

uWSGI 支持多种配置进程的方式

以下是启动 uWSGI 服务器的示例命令:

uwsgi --chdir=/path/to/your/project \

--module=mysite.wsgi:application \

--env DJANGO_SETTINGS_MODULE=mysite.settings \

--master --pidfile=/tmp/project-master.pid \

--socket=127.0.0.1:49152 \ # can also be a file

--processes=5 \ # number of worker processes

--uid=1000 --gid=2000 \ # if root, uwsgi can drop privileges

--harakiri=20 \ # respawn processes taking more than 20 seconds

--max-requests=5000 \ # respawn processes after serving 5000 requests

--vacuum \ # clear environment on exit

--home=/path/to/virtual/env \ # optional path to a virtual environment

--daemonize=/var/log/uwsgi/yourproject.log # background the process

假设你有个叫做 mysite 的顶级项目包,其中包含一个模板 mysite/wsgi.py ,模块包含一个 WSGI application 对象。如果你使用的是较新的 Django,这就是你运行 django-admin startproject mysite (使用你的项目名替换 mysite)后得到的目录结构。若该文件不存在,你需要创建它

Django 指定的参数如下:

  • chdir :需要包含于 Python 的导入路径的目录的路径------例如,包含 mysite 包的目录
  • **module:**要使用的 WSGI 模块------可能是 startproject 创建的 mysite.wsgi 的模块
  • **env:**至少要包括 DJANGO_SETTINGS_MODULE
  • home: 可选的路径,指向你工程的虚拟环境。

示例 INI 配置文件:

[uwsgi]

chdir=/path/to/your/project

module=mysite.wsgi:application

master=True

pidfile=/tmp/project-master.pid

vacuum=True

max-requests=5000

daemonize=/var/log/uwsgi/yourproject.log

示例 INI 配置文件的使用方法:

uwsgi --ini uwsgi.ini

方式三:使用 Apache 和 mod_wsgi 托管 Django

mod_wsgi 是一个 Apache 模块,它可以管理任何 Python WSGI 应用,包括 Django

Django 支持所有支持 mod_wsgi 的 Apache 版本

基础配置

一旦你安装了 mod_wsgi 并且启用了它,请在你的Apache服务器的 httpd.conf 文件中添加如下内容。

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py

WSGIPythonHome /path/to/venv

WSGIPythonPath /path/to/mysite.com

<Directory /path/to/mysite.com/mysite**>**

<Files wsgi.py**>**

Require all granted

</Files>

</Directory>

WSGIScriptAlias 行的第一项是你所期望的应用所在的基础 URL 路径( / 根 url),第二项是 "WSGI 文件" 的位置------一般位于项目包之内(本例中是 mysite)。这告诉 Apache 用该文件中定义的 WSGI 应用响应指定 URL 下的请求。

如果你在某个 virtual environment 1 内为应用安装项目的 Python 依赖,将该 virtualenv 的路径添加至 WSGIPythonHome

WSGIPythonPath 行确保你的项目包能从 Python path 导入

使用 mod_wsgi 后台模式

"Daemon mode" 是运行 mod_wsgi 的推荐模式(在非 Windows 平台上)。为了创建必要的后台进程组并在其中运行 Django 实例,你需要添加合适的 WSGIDaemonProcessWSGIProcessGroup 指令。上述配置在你使用后台模式时需要点小修改,即你不能使用 WSGIPythonPath ;作为替换,你要在 WSGIDaemonProcess 中添加 python-path 选项,例如:

WSGIDaemonProcess example.com python-home=/path/to/venv python-path=/path/to/mysite.com

WSGIProcessGroup example.com

如果你想在子目录中开放你的项目(本例中 https://example.com/mysite ),你可在上述配置中添加 WSGIScriptAlias

WSGIScriptAlias /mysite /path/to/mysite.com/mysite/wsgi.py process-group=example.com

静态文件服务

Django 本身并不提供文件,它把这项工作留给你选择的任何一个网络服务器。

我们建议使用一个单独的 Web 服务器独立提供静态文件服务如:

  • Nginx
  • Apache

参考文档

如何部署 Django - 如何使用 WSGI 进行部署 - 《Django v4.1 中文文档》 - 书栈网 · BookStack

相关推荐
过期动态10 小时前
详解Python面向对象程序设计
开发语言·python·pycharm·django
阿乾之铭11 小时前
通过Django 与 PostgreSQL 进行WEB开发详细流程
python·postgresql·django
春天的菠菜12 小时前
【django】Django REST Framework (DRF) 项目中实现 JWT
后端·python·django·jwt
千里码aicood14 小时前
[含文档+PPT+源码等]精品基于Python实现的django房屋出租系统的设计与实现
开发语言·python·django
啧不应该啊15 小时前
Django替换现有用户模型(auth_user)
后端·python·django
大霸王龙15 小时前
django+postgresql
数据库·后端·python·postgresql·django
hai405871 天前
基于python主观题自动阅卷系统毕业设计项目
spring boot·python·jmeter·django·make与makefile
零七点071 天前
Django遍历文件夹及文件
后端·python·django
是个热心市民1 天前
构建一个导航栏web
前端·javascript·python·django·html
记录学习-python2 天前
web开发Django+vue3
后端·python·django