Как развернуть с 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 по умолчанию находит файл настроек по умолчанию.
Примечание
Поскольку переменные среды являются повсеместными для процесса, это не работает, когда вы запускаете несколько сайтов Django в одном процессе. Это происходит с mod_wsgi.
Чтобы избежать этой проблемы, используйте режим демона mod_wsgi для каждого сайта в отдельном процессе демона или переопределите значение из среды, задав os.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings" в вашем wsgi.py.
Применение WSGI-средств
Для применения WSGI-средств можно обернуть объект приложения. Например, вы можете добавить эти строки в конец wsgi.py:
from helloworld.wsgi import HelloWorldApplication application = HelloWorldApplication(application)
Вы также можете заменить приложение Django WSGI на пользовательское приложение WSGI, которое позже делегирует приложение Django WSGI, если вы хотите объединить приложение Django с приложением WSGI другого фреймворка.
© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/3.1/howto/deployment/wsgi/index/
