getent - оболочка для утилиты unix getent
Новая версия 1.8.
Описание
- Выполняет getent по одной из баз данных и возвращает информацию в факты хоста, в переменной с префиксом getent_<database>
Параметры
| параметр | обязательный | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| database | да | имя базы данных getent, поддерживаемой целевой системой (passwd, group, hosts и т. д.). | ||
| fail_key | нет | True | Если указанный ключ отсутствует, задача завершится с ошибкой, если True | |
| key | нет | ключ, по которому нужно вернуть значения из указанной базы данных, в противном случае возвращается всё содержимое. | ||
| split | нет | None | символ, используемый для разделения значений базы данных на списки/массивы, например, «:» или « », в противном случае он будет пытаться выбрать его в зависимости от базы данных. |
Примеры
# 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, что означает, что разработчики этого модуля гарантируют, что не будут внесены несовместимые изменения в интерфейс.
Информация о поддержке
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если у вас есть желание, пожалуйста, ознакомьтесь со статьей Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/getent_module.html
