ansible.builtin.ini – чтение данных из файла ini
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев, вы можете использовать короткое имя модуля ini даже без указания ключевого слова collections:. Несмотря на это, рекомендуется использовать FQCN для лёгкой ссылки на документацию модуля и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Добавлено в версии 2.0: of ansible.builtin
Описание
- Поиск ini читает содержимое файла в формате INI
key1=value1. Этот плагин извлекает значение справа после знака равенства'='заданного раздела[section]. - Вы также можете прочитать файл свойств, который в этом случае не содержит раздел.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка / обязательный | Ключ(и) для поиска | ||
| default строка | По умолчанию: "" | Возвращаемое значение, если ключ отсутствует в файле ini. | |
| encoding строка | По умолчанию: "utf-8" | Кодировка текста для использования. | |
| file строка | По умолчанию: "ansible.ini" | Имя файла для загрузки. | |
| re булево |
| Флаг, указывающий, является ли предоставленный ключ регулярным выражением. | |
| section строка | По умолчанию: "global" | Раздел для поиска ключа. | |
| type строка |
| Тип файла. 'properties' относится к файлам свойств Java. |
Примеры
- debug: msg="User in integration is {{ lookup('ini', 'user section=integration file=users.ini') }}"
- debug: msg="User in production is {{ lookup('ini', 'user section=production file=users.ini') }}"
- debug: msg="user.name is {{ lookup('ini', 'user.name type=properties file=user.properties') }}"
- debug:
msg: "{{ item }}"
with_ini:
- '.* section=section1 file=test.ini re=True'
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| _raw список / элементы=строка | успех | значение(я) ключа(ей) в файле ini |
Авторы
- Yannig Perre (!UNKNOWN) <yannig.perre(at)gmail.com>
© 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/ini_lookup.html
