Documentation

apache2_module - enables/disables a module of the Apache2 webserver

New in version 1.6.

Synopsis

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

Options

parameter required default choices comments
force
(added in 2.1)
no
  • True
  • False
force disabling of default modules and override Debian warnings
ignore_configcheck
(added in 2.3)
no
  • True
  • False
Ignore configuration checks about inconsistent module configuration. Especially for mpm_* modules.
name
yes
name of the module to enable/disable
state
no present
  • present
  • absent
indicate the desired state of the resource

Examples

# enables the Apache2 module "wsgi"
- apache2_module:
    state: present
    name: wsgi
# disables the Apache2 module "wsgi"
- apache2_module:
    state: absent
    name: wsgi
# disable default modules for Debian
- apache2_module:
    state: absent
    name: autoindex
    force: True
# disable mpm_worker and ignore warnings about missing mpm module
- apache2_module:
    state: absent
    name: mpm_worker
    ignore_configcheck: True

Return Values

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

name description returned type sample
warnings list of warning messages when needed list
stdout stdout of underlying command failed string
result message about action taken always string
stderr stderr of underlying command failed string
rc return code of underlying command failed int


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.