community.general.apache2_module – Enables/disables a module of the Apache2 webserver.

Note

This plugin is part of the community.general collection (version 3.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.apache2_module.

Synopsis

  • Enables or disables a specified module of the Apache2 webserver.

Requirements

The below requirements are needed on the host that executes this module.

  • a2enmod

  • a2dismod

Parameters

Parameter

Comments

force

boolean

Force disabling of default modules and override Debian warnings.

Choices:

  • no ← (default)

  • yes

identifier

string

Identifier of the module as listed by apache2ctl -M. This is optional and usually determined automatically by the common convention of appending _module to name as well as custom exception for popular modules.

ignore_configcheck

boolean

Ignore configuration checks about inconsistent module configuration. Especially for mpm_* modules.

Choices:

  • no ← (default)

  • yes

name

string / required

Name of the module to enable/disable as given to a2enmod/a2dismod.

state

string

Desired state of the module.

Choices:

  • present ← (default)

  • absent

Notes

Note

  • This does not work on RedHat-based distributions. It does work on Debian- and SuSE-based distributions. Whether it works on others depend on whether the a2enmod and a2dismod tools are available or not.

Examples

- 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: Enable dump_io module, which is identified as dumpio_module inside apache2
  community.general.apache2_module:
    state: present
    name: dump_io
    identifier: dumpio_module

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

rc

integer

return code of underlying command

Returned: failed

result

string

message about action taken

Returned: always

stderr

string

stderr of underlying command

Returned: failed

stdout

string

stdout of underlying command

Returned: failed

warnings

list / elements=string

list of warning messages

Returned: when needed

Authors

  • Christian Berendt (@berendt)

  • Ralf Hertel (@n0trax)

  • Robin Roth (@robinro)