Модуль community.general.gunicorn — Запуск gunicorn с различными настройками

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Для использования в книге задач укажите: community.general.gunicorn.

Описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Описание

Запускает gunicorn с указанными параметрами. Поддерживаются общие настройки конфигурации gunicorn. Для дополнительной конфигурации используйте файл конфигурации. См. https://gunicorn-docs.readthedocs.io/en/latest/settings.html для получения дополнительной информации. Рекомендуется всегда использовать опцию chdir, чтобы избежать проблем с местоположением приложения.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

gunicorn

Параметры

Параметр	Комментарии
приложение псевдонимы: имя строка / обязательно	Модуль приложения. Имя ссылается на вызываемый объект WSGI, который должен быть найден в указанном модуле.
chdir путь	Переход в указанный каталог перед загрузкой приложений.
конфигурация псевдонимы: конф путь	Путь к файлу конфигурации gunicorn.
pid путь	Имя файла, используемого для файла PID. Если не указано и не найдено в файле конфигурации, будет создан временный файл PID для проверки успешного запуска gunicorn.
пользователь строка	Переключить рабочие процессы на выполнение от этого пользователя.
venv псевдонимы: virtualenv путь	Путь к каталогу virtualenv.
рабочий строка	Тип используемых рабочих процессов. По умолчанию класс (синхронный) должен обрабатывать большинство «обычных» типов рабочих нагрузок. Варианты: `"sync"` `"eventlet"` `"gevent"` `"tornado "` `"gthread"` `"gaiohttp"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может работать в режиме `check_mode` и возвращать прогнозируемый статус изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Вернет подробности о том, что изменилось (или, возможно, требует изменения в `check_mode`), когда режим diff включен.

Примечания

Примечание

Если не указано в файле конфигурации, временной лог ошибок будет создан в каталоге /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 Возвращается: changed Пример: `"1234"`

Авторы

Alejandro Gomez (@agmezr)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/gunicorn_module.html