Ansible 社区文档

ansible.builtin.service_facts 模块 – 将服务状态信息作为事实数据返回

注意

此模块是ansible-core的一部分，包含在所有Ansible安装中。在大多数情况下，即使不指定collections关键字，也可以使用简短的模块名称service_facts。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.service_facts，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合冲突。

概要 

为各种服务管理实用程序返回服务状态信息作为事实数据。

需求 

以下是执行此模块的主机所需的条件。

以下任何受支持的初始化系统：systemd、sysv、upstart、openrc、AIX SRC

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在check_mode下运行并返回更改状态预测，而无需修改目标，如果不支持，则将跳过该操作。
diff_mode	支持：不支持	处于diff模式时，将返回有关已更改内容（或可能需要在check_mode下更改的内容）的详细信息
facts	支持：完全支持	操作返回一个`ansible_facts`字典，该字典将更新现有的主机事实
platform	平台：posix	可以对其进行操作的目标操作系统/系列

备注 

注意

访问此模块收集的ansible_facts.services事实时，建议不要使用“点表示法”，因为服务在其名称中可能包含-字符，这将导致无效的“点表示法”，例如ansible_facts.services.zuul-gateway。建议改为使用服务名称的字符串值作为键，以便获取事实数据值，例如ansible_facts.services['zuul-gateway']
AIX SRC 在 2.11 版本中添加。

示例 

- name: Populate service facts
  ansible.builtin.service_facts:

- name: Print service facts
  ansible.builtin.debug:
    var: ansible_facts.services

返回的事实 

此模块返回的事实添加到hostvars主机事实中/在其中更新，并且可以像其他任何主机事实一样按名称引用。它们不需要注册即可使用。

键	描述
services 列表 / 元素=字典	以服务名称作为键的服务状态。返回：始终
name 字符串	服务的名称。返回：始终示例：`"arp-ethers.service"`
source 字符串	服务的初始化系统。以下是其中之一：`rcctl`、`systemd`、`sysv`、`upstart`、`src`。返回：始终示例：`"sysv"`
state 字符串	服务的运行状态。这通常包括（但不限于）以下内容：`failed`、`running`、`stopped`或`unknown`。根据使用的初始化系统，可能会返回其他状态。返回：始终示例：`"running"`
status 字符串	服务的运行状态。以下是其中之一：`enabled`、`disabled`、`static`、`indirect`或`unknown`。返回：systemd 系统或 RedHat/SUSE 风格的 sysvinit/upstart 或 OpenBSD 示例：`"enabled"`

作者

Adam Miller (@maxamillion)

集合链接