bigip_iapp_template — Управление шаблонами TCL iApp на BIG-IP
Новая версия с 2.4.
Описание
- Управляет шаблонами TCL iApp на BIG-IP. Этот модуль позволит вам развертывать шаблоны iApp на BIG-IP и управлять их жизненным циклом. Обычный способ использования этого модуля — импорт новых iApp по мере необходимости или путем извлечения содержимого архива iApp, предоставленного на downloads.f5.com, а затем импорт всех iApp с помощью этого модуля. Этот модуль также может обновлять существующие iApp, если источник iApp изменился, а имя осталось прежним. Однако обратите внимание, что этот модуль не будет переконфигурировать какие-либо службы, которые могли быть созданы с помощью модуля
bigip_iapp_service. iApp обычно не обновляются в рабочей среде. Вместо этого новые версии развертываются, а затем существующие службы изменяются для использования нового шаблона. Таким образом, возможность обновления шаблонов на месте требует использования параметраforce.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- f5-sdk >= 3.0.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| content | Устанавливает содержимое шаблона iApp напрямую в указанное значение. Это для простых значений, но может использоваться с плагинами поиска для сложных значений или с форматированием. content должен быть указан при создании новых шаблонов. | ||
| force |
| Указывает, нужно ли принудительно загружать 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) | По умолчанию: None | Объект словаря, содержащий данные подключения. | |
| ssh_keyfile | Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout | По умолчанию: 10 | Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку. | |
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| server_port | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| password обязательно | Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| validate_certs |
| Если no, сертификаты SSL не будут проверяться. Используйте это только на сайтах, контролируемых вами, с самозаверенными сертификатами. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена. | |
| transport обязательно |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| server_port (добавлено в 2.2) | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| state |
| Определяет, должен ли шаблон iApp существовать. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| validate_certs (добавлено в 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
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратной совместимости.
Автор
- 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.5/modules/bigip_iapp_template_module.html
