bigip_iapp_template – Управляет шаблонами TCL iApp на BIG-IP

Новое в версии 2.4.

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

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

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

f5-sdk >= 3.0.16

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
content -			Устанавливает содержимое шаблона iApp напрямую в указанное значение. Это для простых значений, но может использоваться с плагинами поиска для любых сложных значений или с форматированием. `content` необходимо при создании новых шаблонов.
force boolean		Варианты: no yes	Указывает, нужно ли принудительно загружать iApp. Если `yes`, принудительно обновит iApp, даже если существуют службы iApp, использующие его. Однако это не обновит запущенную службу. Используйте `bigip_iapp_service` для этого. Если `no`, обновит iApp только если нет служб iApp, использующих шаблон.
name -			Имя шаблона iApp, который требуется удалить. Этот параметр доступен только при указании `state` `absent`, и служит для удаления шаблонов, исходный код которых более недоступен.
partition -		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
password - / обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_PASSWORD`. Псевдонимы: pass, pwd
provider - добавлен в 2.5		Значение по умолчанию: null	Объект словаря, содержащий данные подключения.
	password - / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_PASSWORD`. Псевдонимы: pass, pwd
	server - / обязательно		Хост BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER`.
	server_port -	Значение по умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
	ssh_keyfile -		Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Можно опустить этот параметр, установив переменную окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout -	Значение по умолчанию: 10	Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку.
	transport - / обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	user - / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную окружения `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Можно опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
server - / обязательно			Хост BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER`.
server_port - добавлен в 2.2		Значение по умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
state -		Варианты: present ← absent	Указывает, должен ли шаблон iApp существовать или нет.
user - / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную окружения `F5_USER`.
validate_certs boolean добавлен в 2.0		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Можно опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.

Примечания

Примечание

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

Примеры

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

- name: Update a template in place
  bigip_iapp_template:
    content: "{{ lookup('template', 'iapp-new.tmpl') }}"
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  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: yes
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

Статус

Этот модуль гарантированно не будет иметь обратной несовместимости в будущих изменениях интерфейса. [stableinterface]
Этот модуль поддерживается партнером Ansible. [certified]

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/bigip_iapp_template_module.html