Spec-Zone.ru › Ansible

f5networks.f5_modules.bigiq_application_fasthttp модуль – Управляет приложениями BIG-IQ FastHTTP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

У вас может быть уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigiq_application_fasthttp.

Новое в f5networks.f5_modules 1.0.0

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

Описание

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

Параметры

Параметр

Комментарии

add_analytics

boolean

Сбор статистики BIG-IP, на котором развернуто приложение.

Этот параметр актуален только при указании service_environment, представляющего BIG-IP; не SSG.

Варианты:

  • false ← (по умолчанию)
  • true

description

string

Описание приложения.

inbound_virtual

dictionary

Настройки виртуального сервера, принимающего входящее подключение.

Эта виртуальная машина используется для размещения HTTP-точки приложения.

address

string / обязательно

Указывает информацию об IP-адресе назначения, куда виртуальный сервер отправляет трафик.

Этот параметр необходим при создании нового приложения.

netmask

string / обязательно

Указывает маску сети, которая должна быть связана с данным destination.

Этот параметр необходим при создании нового приложения.

port

integer

Порт, на котором виртуальная машина ожидает подключения.

При создании нового приложения, если этот параметр не указан, используется значение по умолчанию 80.

По умолчанию: 80

name

string / обязательно

Имя нового приложения.

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект типа dict, содержащий данные подключения.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства.

Этот параметр используется при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, данные телеметрии TEEM не отправляются в F5.

Вы можете опустить этот параметр, установив переменную окружения F5_TELEMETRY_OFF.

Предыдущая переменная F5_TEEM, устарела, так как её название было неоднозначным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательно

Пароль для учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Вы можете опустить этот параметр, установив переменную окружения F5_PASSWORD.

server

string / обязательно

Хост BIG-IP или BIG-IQ.

Вы можете опустить этот параметр, установив переменную окружения F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку.

transport

string

Настраивает транспортное подключение для соединения с удалённым устройством.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательно

Имя пользователя для подключения к BIG-IP или BIG-IQ. Пользователь должен обладать административными правами на устройстве.

Вы можете опустить этот параметр, установив переменную окружения F5_USER.

validate_certs

boolean

Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами.

Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

servers

list / элементы=dictionary

Список серверов, на которых размещено приложение.

Если вы знакомы с другими настройками BIG-IP, вы можете также рассматривать этот список как список членов пула.

При создании нового приложения требуется как минимум один сервер.

address

строка / обязательно

IP-адрес сервера.

port

целое число

Порт сервера.

При создании нового приложения и указании сервера, если этот параметр не указан, используется значение по умолчанию 80.

По умолчанию: 80

service_environment

строка

Указывает имя среды службы, к которой относится приложение.

При создании нового приложения этот параметр обязателен.

Тип среды службы автоматически определяется этим модулем. Поэтому крайне важно поддерживать уникальные имена элементов в различных типах сред службы (на данный момент SSG и BIGIP).

state

строка

Состояние ресурса в системе.

В случае present, гарантирует существование ресурса с указанными атрибутами.

В случае absent, удаляет ресурс из системы.

Значения:

  • "absent"
  • "present" ← (по умолчанию)

wait

булево

Если модуль должен дождаться создания, удаления или обновления приложения.

Значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Этот модуль не поддерживает обновление приложения (развернутого или нет). Если вам нужно обновить приложение, рекомендуется удалить и повторно создать его.
  • Этот модуль не работает на 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: BIG-IQ CM an HTTP application on port 80 on BIG-IP
  bigiq_application_fasthttp:
    name: my-app
    description: Fast HTTP
    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: 80
    provider:
      password: secret
      server: cm.mydomain.com
      user: admin
    state: present
  delegate_to: localhost

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

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

Ключ

Описание

description

строка

Новое описание приложения ресурса.

Возвращаемое значение: changed

Пример: "My application"

inbound_virtual_destination

строка

Назначение виртуального объекта, который был создан.

Возвращаемое значение: changed

Пример: "6.7.8.9"

inbound_virtual_netmask

строка

Маска сети предоставленного входящего назначения.

Возвращаемое значение: changed

Пример: "255.255.255.0"

inbound_virtual_port

целое число

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

Возвращаемое значение: changed

Пример: 80

servers

сложный тип

Список серверов и их портов, составляющих приложение.

Возвращаемое значение: changed

Пример: "hash/dictionary of values"

address

строка

IP-адрес сервера.

Возвращаемое значение: changed

Пример: "2.3.4.5"

port

целое число

Порт, на котором прослушивает сервер.

Возвращаемое значение: changed

Пример: 8080

service_environment

строка

Среда, в которую была развернута служба.

Возвращаемое значение: changed

Пример: "my-ssg1"

Авторы

  • Tim Rupp (@caphrim007)

Ссылки на коллекцию

  • Система отслеживания проблем
  • Главная страница
  • Репозиторий (исходные коды)

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

Spec-Zone.ru

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