Spec-Zone.ru › Ansible 2.10

f5networks.f5_modules.bigip_profile_oneconnect – Управление профилями OneConnect на BIG-IP

Примечание

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

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

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

Новое в версии 1.0.0: модуля f5networks.f5_modules

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

Обзор

  • Управление профилями OneConnect на системе BIG-IP.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
description
строка
Описание профиля.
idle_timeout_override
строка
Указывает количество секунд, в течение которых соединение считается неактивным, прежде чем поток соединения может быть удален.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
Можно указать количество секунд для переопределения таймаута.
Когда disabled, указывает, что для соединения нет переопределения таймаута.
Когда indefinite, указывает, что соединение может быть неактивным без переопределения таймаута.
limit_type
строка
    Варианты:
  • none
  • idle
  • strict
Когда none, одновременные запросы и ответы по TCP-соединениям с членом пула учитываются в лимите. Это историческое поведение.
Когда idle, неактивные соединения будут удалены по достижении предела TCP-соединений. В короткие промежутки времени, во время наложения удаления неактивного соединения и установления нового соединения, предел TCP-соединений может быть превышен.
Когда strict, предел TCP-соединений соблюдается без исключений. Это означает, что неактивные соединения будут препятствовать установлению новых TCP-соединений до их истечения, даже если они могли бы быть повторно использованы.
strict не рекомендуется, за исключением особых случаев с короткими таймаутами истечения.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
maximum_age
целое число
Указывает максимальное количество секунд, разрешенное для соединения в пуле повторного использования соединений.
Для любого соединения, возраст которого превышает это значение, система удаляет это соединение из пула повторного использования.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
maximum_reuse
целое число
Указывает максимальное количество раз, которое соединение на стороне сервера может быть повторно использовано.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
maximum_size
целое число
Указывает максимальное количество соединений, хранимых системой в пуле повторного использования соединений.
Если пул уже заполнен, соединение на стороне сервера закрывается после завершения ответа.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
name
строка / обязательно
Указывает имя профиля OneConnect.
parent
строка
Указывает профиль, настройки которого наследуются этим профилем.
При создании нового профиля, если этот параметр не указан, используется системный профиль oneconnect по умолчанию.
partition
строка
По умолчанию:
"Common"
Раздел устройства для управления ресурсами.
provider
словарь
добавлен в версии 1.0.0 модуля f5networks.f5_modules
Объект словаря, содержащий данные соединения.
auth_provider
строка
Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства.
Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem
логическое значение
    Варианты:
  • no
  • yes
Если yes, данные телеметрии TEEM не отправляются в F5.
Можно опустить этот параметр, задав переменную среды F5_TEEM.
password
строка / обязательно
Пароль для учетной записи пользователя, используемой для подключения к BIG-IP.
Можно опустить этот параметр, задав переменную среды F5_PASSWORD.

псевдонимы: pass, pwd
server
строка / обязательно
Хост BIG-IP.
Можно опустить этот параметр, задав переменную среды F5_SERVER.
server_port
целое число
По умолчанию:
443
Порт сервера BIG-IP.
Можно опустить этот параметр, задав переменную среды F5_SERVER_PORT.
timeout
целое число
Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль вернет ошибку.
transport
строка
    Варианты:
  • rest ←
Настраивает транспортное соединение, используемое при подключении к удаленному устройству.
user
строка / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве.
Можно опустить этот параметр, задав переменную среды F5_USER.
validate_certs
логическое значение
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами.
Можно опустить этот параметр, задав переменную среды F5_VALIDATE_CERTS.
share_pools
логическое значение
    Варианты:
  • no
  • yes
Указывает, что соединения могут быть совместно использованы не только внутри виртуального сервера, но и между похожими виртуальными серверами.
Когда yes, все виртуальные серверы, использующие один и тот же OneConnect и другие внутренние сетевые профили, могут совместно использовать соединения.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
source_mask
строка
Указывает значение, которое система применяет к исходному адресу, чтобы определить его пригодность для повторного использования.
При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля.
Система применяет значение этого параметра к источнику адреса на стороне сервера, чтобы определить его пригодность для повторного использования.
Маска 0 заставляет систему совместно использовать повторно используемые соединения по всем исходным адресам. Маска хоста 32 заставляет систему совместно использовать только те повторно используемые соединения, которые исходят от того же исходного адреса.
При использовании SNAT или SNAT пула, исходный адрес на стороне сервера преобразуется вначале, а затем маска OneConnect применяется к преобразованному адресу.
state
строка
    Варианты:
  • present ←
  • absent
Когда present, гарантирует существование профиля.
Когда absent, гарантирует удаление профиля.

Примечания

Примечание

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

Примеры

- name: Create a OneConnect profile
  bigip_profile_oneconnect:
    name: foo
    state: present
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

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

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

Ключ Возвращаемое значение Описание
description
string
изменённое
Описание профиля.

Пример:
Мой профиль
idle_timeout_override
string
изменённое
Новое значение тайм-аута бездействия.

Пример:
disabled
limit_type
string
изменённое
Новый тип ограничения профиля.

Пример:
idle
maximum_age
integer
изменённое
Максимальное количество секунд, разрешённых для соединения в пуле повторного использования соединений.

Пример:
2000
maximum_reuse
integer
изменённое
Максимальное количество раз, которое серверное соединение может быть повторно использовано.

Пример:
1000
maximum_size
integer
изменённое
Максимальное количество подключений, хранимых системой в пуле повторного использования соединений.

Пример:
3000
share_pools
boolean
изменённое
Использовать соединения совместно между похожими виртуальными серверами.

Пример:
True
source_mask
string
изменённое
Значение, которое система применяет к исходному адресу, чтобы определить его пригодность для повторного использования.

Пример:
255.255.255.255


Авторы

  • Тим Рупп (@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/bigip_profile_oneconnect_module.html

Spec-Zone.ru

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