ansible.builtin.getent – Обёртка над утилитой unix getent
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля getent даже без указания collections: ключевого слова. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 1.8: of ansible.builtin
Краткое описание
- Выполняет getent по одной из баз данных и возвращает информацию в факты хоста, с префиксом getent_<database>.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database строка / обязательно | Имя базы данных getent, поддерживаемой целевой системой (passwd, group, hosts и т. д.). | |
| fail_key логическое значение |
| Если заданный ключ отсутствует, это заставит задачу завершиться ошибкой, если yes. |
| key строка | Значение по умолчанию: "" | Ключ, по которому нужно получить значения из указанной базы данных, в противном случае возвращается всё содержимое. |
| service строка добавлен в 2.9 ansible.builtin | Переопределить все базы данных указанной службой Подлежащая система должна поддерживать флаг service, который не всегда доступен. | |
| 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/getent_module.html
