Ansible Core 文档

ansible.builtin.getent 模块 – unix getent 实用程序的包装器

注意

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

概要 

对它的各种数据库之一运行 getent 并将信息返回到主机的 facts 中，在一个 getent_<database> 前缀变量中。

参数 

参数	注释
database 字符串 / 必需	目标系统支持的 getent 数据库的名称 (passwd、group、hosts 等)。
fail_key 布尔值	如果提供的键缺失，则如果 `true`，这将使任务失败。选项 `false` `true` ← (默认)
key 字符串	从中返回指定数据库值的键，否则返回完整内容。
service 字符串在 Ansible 2.9 中添加	使用指定的 service 覆盖所有数据库底层系统必须支持 service 标志，该标志并不总是可用。
split 字符串	用于将数据库值拆分为列表/数组的字符，例如 `:` 或 `\t`，否则它将尝试根据数据库选择一个。

属性 

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

注释 

注意

并非所有数据库都支持枚举，请查看系统文档以了解详细信息。

示例 

- name: Get root user info
  ansible.builtin.getent:
    database: passwd
    key: root
- ansible.builtin.debug:
    var: ansible_facts.getent_passwd

- name: Get all groups
  ansible.builtin.getent:
    database: group
    split: ':'
- ansible.builtin.debug:
    var: ansible_facts.getent_group

- name: Get all hosts, split by tab
  ansible.builtin.getent:
    database: hosts
- ansible.builtin.debug:
    var: ansible_facts.getent_hosts

- name: Get http service info, no error if missing
  ansible.builtin.getent:
    database: services
    key: http
    fail_key: False
- ansible.builtin.debug:
    var: ansible_facts.getent_services

- name: Get user password hash (requires sudo/root)
  ansible.builtin.getent:
    database: shadow
    key: www-data
    split: ':'
- ansible.builtin.debug:
    var: ansible_facts.getent_shadow

返回的事实 

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

键	描述
getent_<database> 列表 / 元素=字符串	结果列表或单个结果作为数据库提供的字段列表列表元素取决于查询的数据库，有关结构，请参阅 getent 手册页从 2.11 开始，它现在返回多个重复条目，以前它只返回最后一个条目返回：始终

作者

Brian Coca (@bcoca)

集合链接