Модуль f5networks.f5_modules.bigip_iapp_template — управление шаблонами TCL iApp на BIG-IP.

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Эта коллекция уже может быть установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_iapp_template.

Добавлено в f5networks.f5_modules 1.0.0

Обзор
Параметры
Примечания
Примеры

Обзор

Управляет шаблонами TCL iApp на BIG-IP. Этот модуль позволяет развертывать шаблоны iApp на BIG-IP и управлять их жизненным циклом. Обычно этот модуль используют для импорта новых iApp по мере необходимости либо для извлечения содержимого архива iApp, предоставленного на downloads.f5.com, с последующим импортом всех iApp с помощью этого модуля. Модуль также может обновлять существующие iApp, если исходный код iApp изменился, а имя осталось прежним. Обратите внимание, что этот модуль не перенастраивает службы, созданные с помощью модуля bigip_iapp_service. Обычно iApp не обновляют в рабочей среде. Вместо этого развертывают новые версии, а затем изменяют существующие службы, чтобы они использовали новый шаблон. Поэтому для обновления шаблонов на месте требуется параметр force.

Параметры

Параметр	Описание
content string	Задает содержимое шаблона iApp непосредственно указанным значением. Подходит для простых значений, но может использоваться с плагинами поиска для сложных данных или данных с форматированием. При создании новых шаблонов необходимо указать `content`.
force boolean	Указывает, следует ли принудительно загружать iApp. Если значение равно `true`, система принудительно обновляет iApp, даже если ее используют службы iApp. Это не обновляет работающую службу; для этого используйте `bigip_iapp_service`. Если значение равно `false`, система обновляет iApp, только если шаблон не используется службами iApp. Варианты: `false` `true`
name string	Имя шаблона iApp, который требуется удалить. Этот параметр доступен только при указании `state` со значением `absent` и позволяет удалять шаблоны, исходный код которых может быть недоступен.
partition string	Раздел устройства, в котором следует управлять ресурсами. По умолчанию: `"Common"`
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Словарь с параметрами подключения.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется преимущественно при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если значение равно `yes`, данные телеметрии TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` объявлена устаревшей, поскольку ее название было неоднозначным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_PASSWORD`.
server string / обязательный	Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задает время ожидания в секундах при подключении к сетевому устройству или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку.
transport string	Настраивает транспортное подключение для связи с удаленным устройством. Варианты: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды `F5_USER`.
validate_certs boolean	Если значение равно `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
state string	Должен ли шаблон iApp существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется BIG-IP версии >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить специфичную для BIG-IP конфигурацию на диск, обязательно добавьте как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по использованию модуля для сохранения текущей конфигурации см. в документации модуля.

Примеры

- name: Add the iApp contained in template iapp.tmpl
  bigip_iapp_template:
    content: "{{ lookup('template', 'iapp.tmpl') }}"
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Update a template in place
  bigip_iapp_template:
    content: "{{ lookup('template', 'iapp-new.tmpl') }}"
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Update a template in place that has existing services created from it.
  bigip_iapp_template:
    content: "{{ lookup('template', 'iapp-new.tmpl') }}"
    force: true
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_iapp_template_module.html