Spec-Zone.ru › Ansible 2.8

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
строка
    Варианты:
  • cli
  • rest ←
Настраивает транспортное соединение для подключения к удаленному устройству.
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
строка
    Варианты:
  • present ←
  • absent
Требуется ли существование шаблона 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API