Gunicorn

Установка

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 будет невозможно. Вместо этого следует использовать обратный прокси-сервер, такой как nginx или Apache httpd перед Gunicorn.

Вы можете подключиться ко всем внешним 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