Gunicorn

Установка

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

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

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

Запуск

Единственный обязательный аргумент для Gunicorn указывает, как загрузить ваше приложение. Синтаксис {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. Это не то же самое, что Python's async/await, или спецификация 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