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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

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

Требования

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

f5-sdk >= 3.0.9

Параметры

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

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- 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, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.

Техническое обслуживание

Этот модуль помечен как community, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, которые также поддерживаются сообществом Ansible, см. на странице здесь.

Автор

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.6/modules/bigip_iapp_template_module.html