ansible.builtin.ini – чтение данных из файла ini
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля ini даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать полное имя класса (FQCN) для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 2.0: от 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/ini_lookup.html
