-

使用ASGI进行部署

除了WSGI,Django还支持在ASGI上进行部署,ASGI是用于异步Web服务器和应用程序的新兴Python标准。

Django的startproject管理命令为您设置了一个默认的ASGI配置,您可以根据项目的需要对其进行调整,并指导任何符合ASGI的应用服务器使用。

Django包括以下ASGI服务器的入门文档:

  • 如何在Daphne中使用Django
  • 如何在Uvicorn中使用Django

该application对象

与WSGI一样,ASGI也为您提供了一个application可调用对象,应用程序服务器使用该可调用对象与您的代码进行通信。通常application以在服务器可访问的Python模块中命名的对象的形式提供。

该startproject命令将创建一个/asgi.py包含此类application可调用文件的文件 。

开发服务器(runserver)不会使用它,但是任何ASGI服务器都可以在开发或生产中使用它。

ASGI服务器通常采用可调用的应用程序路径作为字符串。对于大多数Django项目,它看起来像myproject.asgi:application。

警告:尽管Django的默认ASGI处理程序将在同步线程中运行所有代码,但如果您选择运行自己的异步处理程序,则必须注意异步安全性。

不要在任何异步代码中调用阻塞同步函数或库。Django禁止您使用非异步安全的Django部分执行此操作,但第三方应用程序或Python库可能并非如此。

配置设置模块

当ASGI服务器加载您的应用程序时,Django需要导入设置模块-定义整个应用程序的位置。

Django使用 DJANGO_SETTINGS_MODULE环境变量以找到适当的设置模块。它必须包含指向设置模块的虚线路径。您可以将不同的值用于开发和生产。这完全取决于您如何组织设置。

如果未设置此变量,则默认asgi.py将其设置为 mysite.settings,其中mysite是项目的名称。

应用ASGI中间件

要应用ASGI中间件,或将Django嵌入另一个ASGI应用程序中,可以将Django的application对象包装在asgi.py文件中。例如:

from some_asgi_library import AmazingMiddleware
application = AmazingMiddleware(application)

在Daphne中使用Django

Daphne是用于UNIX的纯Python ASGI服务器,由Django项目的成员维护。它充当ASGI的参考服务器。

安装Daphne

您可以使用以下命令安装Daphne pip:

python -m pip install daphne

在Daphne中运行Django

安装Daphne后,将daphne提供一个命令来启动Daphne服务器进程。最简单的说,需要使用包含ASGI应用程序对象的模块的位置来调用Daphne,然后是调用该应用程序的位置(用冒号分隔)。

对于典型的Django项目,调用Daphne如下所示:

daphne myproject.asgi:application

这将开始监听一个进程127.0.0.1:8000。它要求您的项目位于Python路径上;确保从与manage.py文件相同的目录中运行此命令。

Django与Uvicorn 的使用

Uvicorn是基于uvloop和的ASGI服务器httptools,着重于速度。

安装Uvicorn 

您可以使用以下命令安装Uvicorn pip:

python -m pip install uvicorn

在Uvicorn运行Django 

安装Uvicorn后,将uvicorn提供运行ASGI应用程序的命令。必须使用包含ASGI应用程序对象的模块的位置来调用Uvicorn,然后再调用该应用程序(由冒号分隔)。

对于一个典型的Django项目,调用Uvicorn如下所示:

uvicorn myproject.asgi:application

这将开始监听一个进程127.0.0.1:8000。它要求您的项目位于Python路径上;确保从与manage.py文件相同的目录中运行此命令。

有关更多高级用法,请阅读Uvicorn文档。

详情参考: https://docs.djangoproject.com/en/3.0/