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.

Requirements (on host that executes module)

  • a2enmod
  • a2dismod

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
rc
return code of underlying command
 failed int
result
message about action taken
 always string
stderr
stderr of underlying command
 failed string
stdout
stdout of underlying command
 failed string
warnings
list of warning messages
 when needed list

Status

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

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/apache2_module_module.html