ansible.builtin.template – получение содержимого файла после шаблонизации с помощью Jinja2
Примечание
Этот модуль является частью ansible-base и включен во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля template, даже не указывая collections: ключевое слово. Несмотря на это, мы рекомендуем использовать FQCN для удобной ссылки на документацию по модулю и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 0.9: of ansible.builtin
Описание
- Возвращает список строк; для каждого шаблона в списке шаблонов, который вы передаёте, возвращает строку, содержащую результат обработки этого шаблона.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка | список файлов для шаблонизации | ||
| convert_data булево |
| Нужно ли преобразовать YAML в данные. Если False, строки, которые являются YAML, останутся без изменений. Взаимоисключающий с параметром jinja2_native. | |
| jinja2_native булево добавлен в 2.11 ansible.builtin |
| Управляет использованием родных типов Jinja2. По умолчанию выключено, даже если глобальное jinja2_native равно True. Не имеет эффекта, если глобальное jinja2_native равно False. Это предоставляет большую гибкость, чем модуль template, который вообще не использует родные типы Jinja2. Взаимоисключающий с параметром convert_data. | |
| variable_end_string строка добавлен в 2.8 ansible.builtin | По умолчанию: "}}" | Строка, обозначающая конец оператора вывода. | |
| variable_start_string строка добавлен в 2.8 ansible.builtin | По умолчанию: "{{" | Строка, обозначающая начало оператора вывода. |
Примеры
- name: show templating results
debug:
msg: "{{ lookup('template', './some_template.j2') }}"
- name: show templating results with different variable start and end string
debug:
msg: "{{ lookup('template', './some_template.j2', variable_start_string='[%', variable_end_string='%]') }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _raw список / элементы=любой | успех | содержимое файла(ов) после шаблонизации |
Авторы
- Michael DeHaan
© 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/template_lookup.html