Как развернуть с 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/4.2/howto/deployment/wsgi/index/
