ansible / ansible.builtin / v2.15.2 / module / getent A wrapper to the unix getent utility | "added in version" 1.8 of ansible.builtin" Authors: Brian Coca (@bcoca)ansible.builtin.getent (v2.15.2) — module
pip
Install with pip install ansible-core==2.15.2
Runs getent against one of it's various databases and returns information into the host's facts, in a getent_<database> prefixed variable.
- 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
key: description: - Key from which to return values from the specified database, otherwise the full contents are returned. type: str split: description: - Character used to split the database values into lists/arrays such as C(:) or C(\t), otherwise it will try to pick one depending on the database. type: str service: description: - Override all databases with the specified service - The underlying system must support the service flag which is not always available. type: str version_added: '2.9' version_added_collection: ansible.builtin database: description: - The name of a getent database supported by the target system (passwd, group, hosts, etc). required: true type: str fail_key: default: 'yes' description: - If a supplied key is missing this will make the task fail if C(true). type: bool
ansible_facts: contains: getent_<database>: description: - A list of results or a single result as a list of the fields the db provides - The list elements depend on the database queried, see getent man page for the structure - Starting at 2.11 it now returns multiple duplicate entries, previouslly it only returned the last one returned: always type: list description: Facts to add to ansible_facts. returned: always type: dict