getent – Обёртка для утилиты unix getent
Синтаксис
- Выполняет getent для одного из его различных баз данных и возвращает информацию в фактах хоста в переменной, начинающейся с getent_<database>.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database - / обязательно | Имя базы данных getent, поддерживаемой целевой системой (passwd, group, hosts и т. д.). | |
| fail_key boolean |
| Если указанный ключ отсутствует, задача завершится неудачно, если yes. |
| key - | Значение по умолчанию: "" | Ключ, по которому возвращаются значения из указанной базы данных, в противном случае возвращается всё содержимое. |
| service - добавлен в 2.9 | Переопределяет все базы данных указанным сервисом. Подлежащая система должна поддерживать флаг сервиса, который не всегда доступен. | |
| 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]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний 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.9/modules/getent_module.html
