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.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| content строка | Устанавливает содержимое шаблона iApp непосредственно в указанное значение. Это для простых значений, но может использоваться с плагинами поиска для чего-либо сложного или с форматированием. content необходимо при создании новых шаблонов. | ||
| force логический тип |
| Указывает, нужно ли принудительно загрузить 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. | |
| ssh_keyfile путь | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Можно опустить этот параметр, задав переменную окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Значение по умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку. | |
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Можно опустить этот параметр, задав переменную окружения F5_USER. | ||
| validate_certs логический тип |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами.Можно опустить этот параметр, задав переменную окружения F5_VALIDATE_CERTS. | |
| 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.
- Требуется версия программного обеспечения 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') }}"
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: yes
state: present
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Статус
- Этот модуль гарантирует отсутствие несовместимых изменений интерфейса в будущем. [stableinterface]
- Этот модуль поддерживается партнером Ansible. [certified]
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/bigip_iapp_template_module.html