uWSGI

Установка

uWSGI имеет несколько способов установки. Самый простой — установить пакет pyuwsgi, который предоставляет предварительно скомпилированные wheel-пакеты для распространённых платформ. Однако он не поддерживает SSL, который можно обеспечить с помощью обратного прокси-сервера.

Создайте виртуальное окружение, установите своё приложение, затем установите pyuwsgi.

$ cd hello-app
$ python -m venv venv
$ . venv/bin/activate
$ pip install .  # install your application
$ pip install pyuwsgi

Если у вас есть доступный компилятор, вы можете установить пакет uwsgi вместо этого. Или установите пакет pyuwsgi из sdist вместо wheel. Любой метод включит поддержку SSL.

$ pip install uwsgi

# or
$ pip install --no-binary pyuwsgi pyuwsgi

Запуск

Самый базовый способ запуска uWSGI — указать ему начать HTTP-сервер и импортировать ваше приложение.

$ uwsgi --http 127.0.0.1:8000 --master -p 4 -w hello:app

*** Starting uWSGI 2.0.20 (64bit) on [x] ***
*** Operational MODE: preforking ***
mounting hello:app on /
spawned uWSGI master process (pid: x)
spawned uWSGI worker 1 (pid: x, cores: 1)
spawned uWSGI worker 2 (pid: x, cores: 1)
spawned uWSGI worker 3 (pid: x, cores: 1)
spawned uWSGI worker 4 (pid: x, cores: 1)
spawned uWSGI http 1 (pid: x)

Если вы используете паттерн фабрики приложений, вам нужно создать небольшой Python-файл для создания приложения, а затем указать uWSGI на этот файл.

from hello import create_app

app = create_app()

$ uwsgi --http 127.0.0.1:8000 --master -p 4 -w wsgi:app

Опция --http запускает HTTP-сервер на 127.0.0.1 порту 8000. Опция --master указывает стандартный менеджер рабочих процессов. Опция -p запускает 4 рабочих процесса; начальное значение может быть CPU * 2. Опция -w указывает uWSGI, как импортировать ваше приложение.

Внешнее связывание

uWSGI не следует запускать от имени root с конфигурацией, показанной в этом документе, потому что это приведет к запуску вашего кода приложения от имени root, что небезопасно. Однако это означает, что будет невозможно связаться с портом 80 или 443. Вместо этого следует использовать обратный прокси-сервер, такой как nginx или Apache httpd, перед uWSGI. Запуск uWSGI от имени root безопасно возможен, но это выходит за рамки данного документа.

uWSGI оптимизировано для интеграции с Nginx uWSGI и Apache mod_proxy_uwsgi, и, возможно, с другими серверами, вместо использования стандартного HTTP-прокси. Эта конфигурация выходит за рамки этого документа, см. ссылки для получения дополнительной информации.

Вы можете связаться со всеми внешними IP-адресами на непривилегированном порту, используя опцию --http 0.0.0.0:8000. Не делайте этого при использовании настройки обратного прокси, иначе будет возможно обойти прокси.

$ uwsgi --http 0.0.0.0:8000 --master -p 4 -w wsgi:app

0.0.0.0 — недействительный адрес для навигации, вы бы использовали определённый IP-адрес в своём браузере.

Асинхронная работа с gevent

По умолчанию синхронный рабочий процесс подходит для многих случаев использования. Если вам нужна асинхронная поддержка, uWSGI предоставляет рабочий процесс gevent. Это не то же самое, что Python's async/await, или спецификация ASGI-сервера. Вам нужно действительно использовать gevent в вашем собственном коде, чтобы увидеть какую-либо выгоду от использования рабочего процесса.

При использовании gevent требуется greenlet>=1.0, в противном случае локальные переменные контекста, такие как request, не будут работать должным образом. При использовании PyPy требуется PyPy>=7.3.7.

$ uwsgi --http 127.0.0.1:8000 --master --gevent 100 -w wsgi:app

*** Starting uWSGI 2.0.20 (64bit) on [x] ***
*** Operational MODE: async ***
mounting hello:app on /
spawned uWSGI master process (pid: x)
spawned uWSGI worker 1 (pid: x, cores: 100)
spawned uWSGI http 1 (pid: x)
*** running gevent loop engine [addr:x] ***