getent - Обёртка для утилиты unix getent
Новая в версии 1.8.
Синтаксис
- Выполняет getent против одной из его баз данных и возвращает информацию в фактах хоста в префиксной переменной getent_<база_данных>.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database обязательно | Имя базы данных getent, поддерживаемой целевой системой (passwd, group, hosts и т. д.). | |
| fail_key bool |
| Если предоставленный ключ отсутствует, это приведет к завершению задачи, если yes. |
| key | Значение по умолчанию: "" | Ключ, из которого нужно вернуть значения из указанной базы данных, в противном случае возвращаются все содержимое. |
| split | Символ, используемый для разделения значений базы данных на списки/массивы, такие как ':' или ' ', в противном случае будет предпринята попытка выбрать один в зависимости от базы данных. |
Примечания
Примечание
- Не все базы данных поддерживают перечисление, см. документацию системы для получения подробностей.
Примеры
# get root user info
- getent:
database: passwd
key: root
- debug:
var: getent_passwd
# get all groups
- getent:
database: group
split: ':'
- debug:
var: getent_group
# get all hosts, split by tab
- getent:
database: hosts
- debug:
var: getent_hosts
# get http service info, no error if missing
- getent:
database: services
key: http
fail_key: False
- debug:
var: getent_services
# get user password hash (requires sudo/root)
- getent:
database: shadow
key: www-data
split: ':'
- debug:
var: getent_shadow
Статус
Этот модуль помечен как stableinterface, что означает, что сотрудники, отвечающие за этот модуль, гарантируют, что не будет внесено обратной несовместимой изменений интерфейса.
Техническое обслуживание
Этот модуль помечен как core, что означает, что его поддерживает Команда Ansible Core. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются командой Ansible Core, см. в здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- 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.6/modules/getent_module.html