ansible.builtin.getent – Обёртка над утилитой unix getent

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля getent, даже без указания collections: ключевого слова. Тем не менее, рекомендуется использовать полное имя класса (FQCN) для лёгкой ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 1.8: из ansible.builtin

Описание
Параметры
Примечания
Примеры

Описание

Выполняет getent по одной из баз данных и возвращает информацию в факты хоста, с префиксом getent_<database> для переменных.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
database строка / обязательно		Имя базы данных getent, поддерживаемой целевой системой (passwd, group, hosts и т. д.).
fail_key булево	Варианты: no yes ←	Если предоставленный ключ отсутствует, это заставит задачу завершиться с ошибкой, если `yes`.
key строка	Значение по умолчанию: ""	Ключ, из которого нужно вернуть значения из указанной базы данных, в противном случае возвращаются все содержимое.
service строка добавлено в версии 2.9 ansible.builtin		Переопределить все базы данных указанным сервисом Подлежащая система должна поддерживать флаг сервиса, что не всегда доступно.
split строка		Символ, используемый для разделения значений базы данных на списки/массивы, например, ':' или ' ', в противном случае будет предпринята попытка выбрать один в зависимости от базы данных.

Примечания

Примечание

Не все базы данных поддерживают перечисление, см. документацию системы для получения подробной информации.

Примеры

- name: Get root user info
  getent:
    database: passwd
    key: root
- debug:
    var: getent_passwd

- name: Get all groups
  getent:
    database: group
    split: ':'
- debug:
    var: getent_group

- name: Get all hosts, split by tab
  getent:
    database: hosts
- debug:
    var: getent_hosts

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

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

Авторы

Brian Coca (@bcoca)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/getent_module.html