New in version 1.6.
The below requirements are needed on the host that executes this module.
Parameter |
Choices/Defaults |
Comments |
|---|---|---|
|
force
(added in 2.1) |
no
|
Force disabling of default modules and override Debian warnings.
|
|
identifier
(added in 2.5) |
|
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
(added in 2.3) |
no
|
Ignore configuration checks about inconsistent module configuration. Especially for mpm_* modules.
|
|
name
required |
|
Name of the module to enable/disable as given to
a2enmod/a2dismod. |
|
state
|
|
Desired state of the module.
|
# 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
# enable dump_io module, which is identified as dumpio_module inside apache2
- apache2_module:
state: present
name: dump_io
identifier: dumpio_module
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
|---|---|---|
|
rc
int
|
failed |
return code of underlying command
|
|
result
string
|
always |
message about action taken
|
|
stderr
string
|
failed |
stderr of underlying command
|
|
stdout
string
|
failed |
stdout of underlying command
|
|
warnings
list
|
when needed |
list of warning messages
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.