Как использовать Django с uWSGI

uWSGI — это быстрый, самовосстанавливающийся и удобный для разработчиков/системных администраторов контейнерный сервер приложений, написанный на чистом C.

Предварительные требования: uWSGI

В вики uWSGI описаны несколько процедур установки. Используя менеджер пакетов Python — pip, вы можете установить любую версию uWSGI одной командой. Например:

# Install current stable version.
$ pip install uwsgi

# Or install LTS (long term support).
$ pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz

Модель uWSGI

uWSGI работает по модели клиент-сервер. Ваш веб-сервер (например, nginx, Apache) взаимодействует с процессом django-uwsgi «работник» для предоставления динамического контента.

Настройка и запуск сервера 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 virtualenv
    --daemonize=/var/log/uwsgi/yourproject.log      # background the process

Предполагается, что у вас есть пакет проекта верхнего уровня, названный mysite, и внутри него модуль mysite/wsgi.py содержащий объект WSGI application. Такая структура будет, если вы выполните django-admin startproject mysite (замените mysite на имя вашего проекта) с недавней версией Django. Если этот файл не существует, вам нужно его создать. Обратитесь к документации по развертыванию с WSGI за информацией о стандартном содержимом этого файла и о том, что ещё можно добавить.

Специфичные для Django опции здесь:

• chdir: Путь к каталогу, который должен быть на пути импорта Python — то есть, каталог, содержащий пакет mysite.
• module: Модуль WSGI для использования — скорее всего, модуль mysite.wsgi созданный командой startproject.
• 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

env = LANG=en_US.UTF-8

См. документацию uWSGI по управлению процессом uWSGI для получения информации о запуске, остановке и перезагрузке процессов uWSGI.