community.general.apache2_module модуль — Включение/выключение модуля веб-сервера Apache2

Примечание

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

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

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

Для использования в playbook укажите: community.general.apache2_module.

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

Описание

Включает или отключает указанный модуль веб-сервера Apache2.

Требования

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

a2enmod
a2dismod

Параметры

Параметр	Комментарии
force boolean	Принудительное отключение модулей по умолчанию и игнорирование предупреждений Debian. Варианты: `false` ← (по умолчанию) `true`
identifier string	Идентификатор модуля, как указано в `apache2ctl -M`. Это необязательно и обычно определяется автоматически по общепринятой схеме добавления `_module` к `name`, а также по пользовательским исключениям для популярных модулей.
ignore_configcheck boolean	Игнорировать проверки конфигурации относительно несовместимой конфигурации модулей. Особенно для модулей mpm_. Варианты:* `false` ← (по умолчанию) `true`
name string / обязательно	Имя модуля для включения/отключения, как указано в `a2enmod/a2dismod`.
state string	Желаемое состояние модуля. Варианты: `"present"` ← (по умолчанию) `"absent"`
warn_mpm_absent boolean добавлено в community.general 6.3.0	Управление поведением процесса вывода предупреждений для модулей MPM. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примечания

Примечание

Это не работает на дистрибутивах на основе RedHat. Оно работает на дистрибутивах на основе Debian и SuSE. Работа на других дистрибутивах зависит от наличия инструментов a2enmod и a2dismod.

Примеры

- name: Enable the Apache2 module wsgi
  community.general.apache2_module:
    state: present
    name: wsgi

- name: Disables the Apache2 module wsgi
  community.general.apache2_module:
    state: absent
    name: wsgi

- name: Disable default modules for Debian
  community.general.apache2_module:
    state: absent
    name: autoindex
    force: true

- name: Disable mpm_worker and ignore warnings about missing mpm module
  community.general.apache2_module:
    state: absent
    name: mpm_worker
    ignore_configcheck: true

- name: Disable mpm_event, enable mpm_prefork and ignore warnings about missing mpm module
  community.general.apache2_module:
    name: "{{ item.module }}"
    state: "{{ item.state }}"
    warn_mpm_absent: false
    ignore_configcheck: true
  loop:
  - module: mpm_event
    state: absent
  - module: mpm_prefork
    state: present

- name: Enable dump_io module, which is identified as dumpio_module inside apache2
  community.general.apache2_module:
    state: present
    name: dump_io
    identifier: dumpio_module

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Описание
rc целое число	код возврата команды-обработчика Возвращается: при ошибке
result строка	сообщение об выполненном действии Возвращается: всегда
stderr строка	stderr команды-обработчика Возвращается: при ошибке
stdout строка	stdout команды-обработчика Возвращается: при ошибке
warnings список / элементы=строка	список сообщений об ошибках Возвращается: при необходимости

Авторы

Christian Berendt (@berendt)
Ralf Hertel (@n0trax)
Robin Roth (@robinro)

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

© 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/apache2_module_module.html