Как развернуть с WSGI

Основной платформой развертывания Django является WSGI, стандарт Python для веб-серверов и приложений.

Команда управления Django startproject настраивает для вас минимальную конфигурацию WSGI по умолчанию, которую вы можете настроить по мере необходимости для вашего проекта и направить любой сервер приложений, совместимый с WSGI.

Django включает документацию для запуска с следующими серверами WSGI:

• Как использовать Django с Gunicorn
• Как использовать Django с uWSGI
• Как использовать Django с Apache и mod_wsgi
• Как аутентифицироваться по базе данных пользователей Django с Apache

Объект application

Ключевой концепцией развертывания с WSGI является вызываемый объект application, который сервер приложения использует для связи со своим кодом. Он обычно предоставляется как объект с именем application в модуле Python, доступном для сервера.

Команда startproject создает файл <project_name>/wsgi.py, который содержит такой вызываемый объект application.

Он используется как сервером разработки Django, так и в развертываниях WSGI в производстве.

Серверы WSGI получают путь к вызываемому объекту application из своей конфигурации. Встроенный сервер Django, а именно команда runserver, считывает его из настройки WSGI_APPLICATION. По умолчанию он устанавливается в <project_name>.wsgi.application, что указывает на вызываемый объект application в <project_name>/wsgi.py.

Настройка модуля настроек

При загрузке сервером WSGI вашего приложения, Django необходимо импортировать модуль настроек — там определено ваше приложение.

Django использует переменную среды DJANGO_SETTINGS_MODULE для поиска соответствующего модуля настроек. Она должна содержать путь с точками к модулю настроек. Вы можете использовать различные значения для разработки и производства; все зависит от того, как вы организовали свои настройки.

Если эта переменная не установлена, по умолчанию wsgi.py устанавливает ее в mysite.settings, где mysite — имя вашего проекта. Так runserver по умолчанию находит файл настроек по умолчанию.

Применение WSGI-среднего ПО

Чтобы применить WSGI-среднее ПО, можно обернуть объект приложения. Например, вы можете добавить эти строки в конец wsgi.py:

from helloworld.wsgi import HelloWorldApplication

application = HelloWorldApplication(application)

Также можно заменить приложение Django WSGI на пользовательское приложение WSGI, которое позже делегирует вызовы приложению Django WSGI, если вы хотите объединить приложение Django с приложением WSGI другого фреймворка.