Spec-Zone.ru › Ansible 2.11

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

Примечание

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

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

Чтобы использовать его в playbook, укажите: f5networks.f5_modules.bigiq_application_http.

Новое в версии 1.0.0: of f5networks.f5_modules

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

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
add_analytics
boolean
    Варианты:
  • нет ←
  • да
Сбор статистики 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 of f5networks.f5_modules
Объект типа dict, содержащий данные подключения.
auth_provider
string
Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства.
Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem
boolean
    Варианты:
  • нет
  • да
Если 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, сертификаты 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
    Варианты:
  • нет
  • да ←
Если модуль должен ждать создания, удаления или обновления приложения.

Примечания

Примечание

  • Этот модуль не поддерживает обновление приложения (развернуто или нет). Если вам нужно обновить приложение, рекомендуется удалить и повторно создать его.
  • Этот модуль не будет работать на 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
изменённый
Новое описание применения ресурса.

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

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

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

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

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

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

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

Пример:
my-ssg1


Авторы

  • Tim Rupp (@caphrim007)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigiq_application_http_module.html

Spec-Zone.ru

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