Spec-Zone.ru › Ansible 2.10

f5networks.f5_modules.bigiq_application_http – Управляет HTTP-приложениями BIG-IQ

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigiq_application_http.

Добавлен в версии 1.0.0: модуля f5networks.f5_modules

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Управляет приложениями BIG-IQ, используемыми для балансировки нагрузки HTTP-приложения на порту 80 на системах BIG-IP.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
add_analytics
boolean
    Варианты:
  • no ←
  • yes
Сбор статистики BIG-IP, на котором развернуто приложение.
Этот параметр актуален только при указании service_environment, являющегося BIG-IP; не SSG.
description
string
Описание приложения.
inbound_virtual
dictionary
Настройки для настройки виртуального сервера, принимающего входящее соединение.
Эта виртуальная машина используется для размещения HTTP-точки входа приложения.
address
string / обязательно
Указывает информацию об IP-адресе назначения, в который виртуальный сервер отправляет трафик.
Этот параметр требуется при создании нового приложения.
netmask
string / обязательно
Указывает маску подсети, которую следует ассоциировать с заданным destination.
Этот параметр требуется при создании нового приложения.
port
string
По умолчанию:
80
Порт, на котором виртуальный сервер ожидает подключения.
При создании нового приложения, если этот параметр не указан, значение по умолчанию равно 80.
name
string / обязательно
Имя нового приложения.
provider
dictionary
добавлен в 1.0.0 f5networks.f5_modules
Объект словаря, содержащий данные подключения.
auth_provider
string
Настраивает поставщика аутентификации для получения маркеров аутентификации с удалённого устройства.
Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem
boolean
    Варианты:
  • no
  • yes
Если yes, данные телеметрии TEEM не отправляются в F5.
Вы можете опустить этот параметр, установив переменную среды F5_TEEM.
password
string / обязательно
Пароль для учётной записи пользователя, используемой для подключения к BIG-IP.
Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.

псевдонимы: pass, pwd
server
string / обязательно
Хост BIG-IP.
Вы можете опустить этот параметр, установив переменную среды F5_SERVER.
server_port
integer
По умолчанию:
443
Порт сервера BIG-IP.
Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT.
timeout
integer
Устанавливает таймаут в секундах для взаимодействия с сетевым устройством при подключении или отправке команд. Если таймаут превышен до завершения операции, модуль вернёт ошибку.
transport
string
    Варианты:
  • rest ←
Настраивает транспортное соединение, используемое при подключении к удалённому устройству.
user
string / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве.
Вы можете опустить этот параметр, установив переменную среды F5_USER.
validate_certs
boolean
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами.
Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS.
servers
list / элементы=dictionary
Список серверов, на которых размещено приложение.
Если вы знакомы с другими настройками BIG-IP, вы можете также ссылаться на этот список как на список членов пула.
При создании нового приложения требуется как минимум один сервер.
address
string / обязательно
IP-адрес сервера.
port
string
По умолчанию:
80
Порт сервера.
При создании нового приложения и указании сервера, если этот параметр не предоставлен, по умолчанию используется 80.
service_environment
string
Указывает имя среды сервиса, в которой развернуто приложение.
При создании нового приложения этот параметр необходим.
Тип среды сервиса автоматически обнаруживается этим модулем. Поэтому крайне важно поддерживать уникальные имена для элементов в различных типах сред сервиса (на данный момент SSG и BIG-IP).
state
string
    Варианты:
  • absent
  • present ←
Состояние ресурса в системе.
При present, гарантирует существование ресурса с указанными атрибутами.
При absent, удаляет ресурс из системы.
wait
boolean
    Варианты:
  • no
  • yes ←
Если модуль должен дождаться создания, удаления или обновления приложения.

Примечания

Примечание

  • Этот модуль не поддерживает обновление приложения (развёрнутого или нет). Если вам нужно обновить приложение, рекомендуется удалить и воссоздать его.
  • Этот модуль не будет работать с BIG-IQ версии 6.1.x или выше.
  • Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется версия программного обеспечения BIG-IP >= 12.
  • Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы гарантировать сохранение специфичной для BIG-IP конфигурации в файле, убедитесь, что вы включили как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля за правильным использованием для сохранения текущей конфигурации.

Примеры

- name: Load balance an HTTP application on port 80 on BIG-IP
  bigiq_application_http:
    name: my-app
    description: Redirect HTTP to HTTPS
    service_environment: my-ssg
    servers:
      - address: 1.2.3.4
        port: 8080
      - address: 5.6.7.8
        port: 8080
    inbound_virtual:
      name: foo
      address: 2.2.2.2
      netmask: 255.255.255.255
      port: 443
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
    state: present
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
description
string
changed
Новое описание приложения ресурса.

Пример:
Моё приложение
inbound_virtual_destination
string
changed
Назначение виртуального адреса, которое было создано.

Пример:
6.7.8.9
inbound_virtual_netmask
string
changed
Маска сети предоставленного входящего назначения.

Пример:
255.255.255.0
inbound_virtual_port
integer
changed
Порт, на котором прослушивает входящий виртуальный адрес.

Пример:
80
servers
complex
changed
Список серверов и их портов, составляющих приложение.

Пример:
хеш/словарь значений
address
string
changed
IP-адрес сервера.

Пример:
2.3.4.5
port
integer
changed
Порт, на котором прослушивает сервер.

Пример:
8080
service_environment
string
changed
Среда, в которую было развернуто приложение.

Пример:
my-ssg1


Авторы

  • 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.10/collections/f5networks/f5_modules/bigiq_application_http_module.html

Spec-Zone.ru

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