Gunicorn

Gunicorn — это чистый Python WSGI-сервер с простой конфигурацией и несколькими реализациями рабочих процессов для настройки производительности.

Он обычно легко интегрируется с платформами хостинга.
Он не поддерживает Windows (но работает под WSL).
Его легко установить, так как он не требует дополнительных зависимостей или компиляции.
Он имеет встроенную поддержку асинхронных рабочих процессов с использованием gevent или eventlet.

Эта страница описывает основы запуска Gunicorn. Обязательно прочитайте его документацию и используйте gunicorn --help для понимания доступных функций.

Установка

Gunicorn легко установить, так как он не требует внешних зависимостей или компиляции. Он работает под Windows только в среде WSL.

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

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

Запуск

Единственный необходимый аргумент для Gunicorn сообщает ему, как загрузить ваше приложение Flask. Синтаксис {module_import}:{app_variable}. module_import — это импортируемое имя модуля с вашим приложением. app_variable — это переменная с приложением. Это также может быть вызов функции (с любыми аргументами), если вы используете шаблон приложения-фабрики.

# equivalent to 'from hello import app'
$ gunicorn -w 4 'hello:app'

# equivalent to 'from hello import create_app; create_app()'
$ gunicorn -w 4 'hello:create_app()'

Starting gunicorn 20.1.0
Listening at: http://127.0.0.1:8000 (x)
Using worker: sync
Booting worker with pid: x
Booting worker with pid: x
Booting worker with pid: x
Booting worker with pid: x

Опция -w указывает количество запускаемых процессов; начальное значение может быть CPU * 2. По умолчанию используется только 1 рабочий процесс, что, вероятно, не то, что вам нужно для типа рабочего процесса по умолчанию.

Логи для каждого запроса по умолчанию не отображаются, отображается только информация о рабочих процессах и ошибки. Чтобы отобразить логи доступа на стандартном выходе, используйте опцию --access-logfile=-.

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

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

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

$ gunicorn -w 4 -b 0.0.0.0 'hello:create_app()'
Listening at: http://0.0.0.0:8000 (x)

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

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

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

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

Для использования gevent:

$ gunicorn -k gevent 'hello:create_app()'
Starting gunicorn 20.1.0
Listening at: http://127.0.0.1:8000 (x)
Using worker: gevent
Booting worker with pid: x

Для использования eventlet:

$ gunicorn -k eventlet 'hello:create_app()'
Starting gunicorn 20.1.0
Listening at: http://127.0.0.1:8000 (x)
Using worker: eventlet
Booting worker with pid: x