Модуль community.general.apache2_module — включает/отключает модуль веб-сервера Apache2

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: community.general.apache2_module.

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

Краткое описание

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

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

a2enmod
a2dismod

Параметры

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

Атрибуты

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

Примечания

Примечание

Этот модуль не работает в дистрибутивах на базе 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

Возвращаемые значения

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

Ключ	Описание
result строка	Сообщение о выполненном действии. Возвращается: всегда

Авторы

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

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

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