community.general.gunicorn – Запуск gunicorn с различными настройками.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в книге задач укажите: community.general.gunicorn
Обзор
- Запускает gunicorn с указанными параметрами. Поддерживаются общие настройки конфигурации gunicorn. Для дополнительных настроек используйте конфигурационный файл. Смотрите https://gunicorn-docs.readthedocs.io/en/latest/settings.html для получения дополнительных опций. Рекомендуется всегда использовать опцию chdir, чтобы избежать проблем с расположением приложения.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- gunicorn
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| app строка / обязательно | Модуль приложения. Имя ссылается на вызываемый объект WSGI, который должен быть найден в указанном модуле. псевдонимы: name | |
| chdir путь | Изменить текущую директорию на указанную перед загрузкой приложений. | |
| config путь | Путь к файлу конфигурации gunicorn. псевдонимы: conf | |
| pid путь | Имя файла для PID-файла. Если не задан и не найден в файле конфигурации, будет создан временный PID-файл для проверки успешного запуска gunicorn. | |
| user строка | Переключить рабочие процессы на запуск от имени этого пользователя. | |
| venv путь | Путь к каталогу виртуальной среды. псевдонимы: virtualenv | |
| worker строка |
| Тип рабочих процессов для использования. По умолчанию (sync) должен обрабатывать большинство "обычных" типов задач. |
Примечания
Примечание
- Если не указано в файле конфигурации, временной лог ошибок будет создан в каталоге /tmp. Убедитесь, что у вас есть права записи в /tmp. Не обязательно, но поможет определить любые проблемы с конфигурацией.
Примеры
- name: Simple gunicorn run example
community.general.gunicorn:
app: 'wsgi'
chdir: '/workspace/example'
- name: Run gunicorn on a virtualenv
community.general.gunicorn:
app: 'wsgi'
chdir: '/workspace/example'
venv: '/workspace/example/venv'
- name: Run gunicorn with a config file
community.general.gunicorn:
app: 'wsgi'
chdir: '/workspace/example'
conf: '/workspace/example/gunicorn.cfg'
- name: Run gunicorn as ansible user with specified pid and config file
community.general.gunicorn:
app: 'wsgi'
chdir: '/workspace/example'
conf: '/workspace/example/gunicorn.cfg'
venv: '/workspace/example/venv'
pid: '/workspace/example/gunicorn.pid'
user: 'ansible'
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| gunicorn строка | изменено | идентификатор процесса gunicorn Пример: 1234 |
Авторы
- Alejandro Gomez (@agmezr)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/gunicorn_module.html