community.general.apache2_module 模块 – 启用/禁用 Apache2 web 服务器的模块

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。要使用此模块，您需要满足其他要求，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定： community.general.apache2_module。

概要

  • 启用或禁用指定的 Apache2 web 服务器模块。

要求

执行此模块的主机需要以下要求。

  • a2enmod

  • a2dismod

参数

参数

注释

force

布尔值

强制禁用默认模块并覆盖 Debian 警告。

选项

  • false ← (默认)

  • true

identifier

字符串

由 apache2ctl -M 列出的模块标识符。这是可选的，通常通过将 _module 附加到 name 以及常用模块的自定义异常来自动确定。

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

返回值

常见的返回值已记录在 此处，以下是此模块特有的字段

键

描述

rc

整数

底层命令的返回码

返回：失败时

result

字符串

有关采取的操作的消息

返回：始终返回

stderr

字符串

底层命令的 stderr

返回：失败时

stdout

字符串

底层命令的 stdout

返回：失败时

warnings

列表 / 元素=字符串

警告消息列表

返回：需要时

作者

  • Christian Berendt (@berendt)

  • Ralf Hertel (@n0trax)

  • Robin Roth (@robinro)