Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_profile_fastl4 — управление профилями Fast L4

Примечание

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

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

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

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

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

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

Краткое описание

  • Управляет профилями Fast L4. Использование профиля FastL4 может повысить производительность и пропускную способность виртуального сервера на поддерживаемых платформах за счёт ускорения трафика с помощью встроенного чипа Packet Velocity Acceleration (ePVA).

Параметры

Параметр

Комментарии

client_timeout

string

Задает время ожидания для отложенной привязки.

Это время, в течение которого клиент должен предоставить данные приложения, необходимые для выбора внутреннего сервера; иначе говоря, максимальное время, в течение которого система BIG-IP ожидает информацию об отправителе и целевом объекте.

Эта информация обычно поступает в начале пакета FIX logon.

Если задано 0 или immediate, дополнительное время не предоставляется: отсчет заканчивается в момент передачи первого пакета.

Если задано indefinite, ограничение отключается. Клиент получает неограниченное время для отправки сведений об отправителе и целевом объекте.

description

string

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

explicit_flow_migration

boolean

Определяет, требуется ли для переноса подходящего соединения с отложенной привязкой на аппаратное обеспечение ePVA явная команда iRule.

Если задано false, соединение с отложенной привязкой переносится на ePVA сразу после установления соединения со стороны сервера.

Если задано true, этот параметр отключает автоматический перенос на ePVA и требует, чтобы iRule явно инициировало обработку ePVA с помощью команды iRule release_flow. Это позволяет автору iRule управлять моментом использования аппаратного обеспечения ePVA для соединения.

Допустимые значения:

  • false
  • true

hardware_syn_cookie

boolean

Включает или отключает поддержку аппаратных SYN cookie, если в системе имеется PVA10.

Допустимые значения:

  • false
  • true

idle_timeout

string

Задает продолжительность простоя соединения (отсутствия трафика), по истечении которой его можно удалить.

При создании профиля, если этот параметр не указан, удаленное устройство выбирает значение по умолчанию, подходящее для профиля, на основе профиля parent.

Если указано число, оно задает количество секунд, в течение которых TCP-соединение может оставаться бездействующим до удаления системой.

Если задано indefinite, TCP-соединения не удаляются системой независимо от продолжительности простоя.

Если задано 0 или immediate, соединения удаляются системой сразу после перехода в состояние простоя.

ip_df_mode

string

Задает значение бита Don’t Fragment (DF) в IP-заголовке исходящего TCP-пакета.

Если задано pmtu, бит DF исходящего IP-заголовка устанавливается на основе параметра IP pmtu.

Если задано preserve, бит DF в IP-заголовке исходящего пакета устанавливается в соответствии со значением бита DF во входящем IP-заголовке.

Если задано set, устанавливается бит DF в IP-заголовке исходящего пакета.

Если задано clear, бит DF в IP-заголовке исходящего пакета сбрасывается.

Допустимые значения:

  • "pmtu"
  • "preserve"
  • "set"
  • "clear"

ip_tos_to_client

string

Для IP-трафика, проходящего через систему к клиентам, задает, изменяет ли система параметр типа обслуживания IP (ToS) в заголовке IP-пакета.

Может быть задано число от 0 до 255 включительно. Если указано число, оно задает значение ToS IP, которое система помещает в заголовок IP-пакета.

Если задано pass-through, значение ToS IP остается без изменений.

Если задано mimic, уровень ToS исходящих пакетов устанавливается равным уровню ToS последнего полученного входящего пакета.

ip_tos_to_server

string

Для IP-трафика, проходящего через систему к внутренним серверам, задает, изменяет ли система параметр типа обслуживания IP (ToS) в заголовке IP-пакета.

Может быть задано число от 0 до 255 включительно. Если указано число, оно задает значение ToS IP, которое система помещает в заголовок IP-пакета.

Если задано pass-through, значение ToS IP остается без изменений.

Если задано mimic, уровень ToS исходящих пакетов устанавливается равным уровню ToS последнего полученного входящего пакета.

ip_ttl_mode

string

Задает режим TTL в IP-заголовке исходящего TCP-пакета.

Если задано proxy, значение TTL в исходящем IP-заголовке устанавливается равным 255/64 для IPv4/IPv6 соответственно.

Если задано preserve, значение TTL в исходящем IP-заголовке устанавливается равным значению TTL во входящем IP-заголовке.

Если задано decrement, значение TTL в исходящем IP-заголовке устанавливается на единицу меньше значения TTL во входящем пакете.

Если задано set, значение TTL в исходящем IP-заголовке устанавливается в определенное значение (заданное параметром ip_ttl_v4 или ip_ttl_v6).

Допустимые значения:

  • "proxy"
  • "preserve"
  • "decrement"
  • "set"

ip_ttl_v4

integer

Задает значение TTL в IP-заголовке исходящего пакета для трафика IPv4.

Максимальное значение TTL — 255.

ip_ttl_v6

integer

Задает значение TTL в IP-заголовке исходящего пакета для трафика IPv6.

Максимальное значение TTL — 255.

keep_alive_interval

integer

Задает интервал между проверочными пакетами keep-alive в секундах.

late_binding

boolean

Включает интеллектуальный выбор внутреннего сервера или пула с помощью iRule.

Для включения late_binding на BIG-IP под управлением ветки TMOS 12.x необходимо включить программные SYN cookie.

Допустимые значения:

  • false
  • true

link_qos_to_client

string

Для IP-трафика, проходящего через систему к клиентам, задает, изменяет ли система параметр качества обслуживания канала (QoS) в заголовке IP-пакета.

Значение QoS канала определяет приоритет IP-пакета относительно другого трафика уровня 2.

Можно указать число от 0 (самый низкий приоритет) до 7 (самый высокий приоритет).

Если указано число, оно задает значение QoS канала, которое система помещает в заголовок IP-пакета.

Если задано pass-through, значение QoS канала остается без изменений.

link_qos_to_server

string

Для IP-трафика, проходящего через систему к внутренним серверам, задает, изменяет ли система параметр качества обслуживания канала (QoS) в заголовке IP-пакета.

Значение QoS канала определяет приоритет IP-пакета относительно другого трафика уровня 2.

Можно указать число от 0 (самый низкий приоритет) до 7 (самый высокий приоритет).

Если указано число, оно задает значение QoS канала, которое система помещает в заголовок IP-пакета.

Если задано pass-through, значение QoS канала остается без изменений.

loose_close

boolean

Если задано true, система закрывает соединение, установленное в упрощенном режиме, при получении первого пакета FIN от клиента или сервера.

Допустимые значения:

  • false
  • true

loose_initialization

boolean

Если задано true, система устанавливает соединение при получении любого TCP-пакета, не требуя для его установки пакет SYN.

Допустимые значения:

  • false
  • true

mss_override

integer

Задает переопределение максимального размера сегмента (MSS) для соединений со стороны сервера.

Допустимый диапазон — от 256 до 9162; значение 0 отключает параметр.

name

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

Задает имя профиля.

parent

string

Задает профиль, от которого этот профиль наследует параметры.

При создании профиля, если этот параметр не указан, по умолчанию используется системный профиль fastL4.

partition

string

Раздел устройства для управления ресурсами.

По умолчанию: "Common"

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 ← (по умолчанию)

pva_acceleration

string

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

Задает политику ускорения Packet Velocity ASIC.

Допустимые значения:

  • "full"
  • "dedicated"
  • "partial"
  • "none"

reassemble_fragments

boolean

Если задано true, система собирает IP-фрагменты.

Допустимые значения:

  • false
  • true

receive_window_size

integer

Задает объем данных, который система BIG-IP может принять без подтверждения от сервера.

reset_on_timeout

boolean

Если задано true, при превышении соединением времени ожидания простоя система отправляет пакет сброса (RST) и удаляет соединение.

Допустимые значения:

  • false
  • true

rtt_from_client

boolean

Если задано true, система использует параметры временных меток TCP для измерения времени прохождения сигнала до клиента и обратно.

Допустимые значения:

  • false
  • true

rtt_from_server

boolean

Если задано true, система использует параметры временных меток TCP для измерения времени прохождения сигнала до сервера и обратно.

Допустимые значения:

  • false
  • true

server_sack

boolean

Определяет, обрабатывает ли система BIG-IP пакеты Selective ACK (Sack) в ответах сервера на cookie.

Допустимые значения:

  • false
  • true

server_timestamp

boolean

Определяет, обрабатывает ли система BIG-IP пакеты запроса временной метки в ответах сервера на cookie.

Допустимые значения:

  • false
  • true

state

string

Если задано present, обеспечивает наличие профиля.

Если задано absent, обеспечивает удаление профиля.

Допустимые значения:

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

syn_cookie_enable

boolean

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

Определяет, использовать ли SYN Cookie.

Допустимые значения:

  • false
  • true

syn_cookie_mss

integer

Задает значение, переопределяющее максимальный размер сегмента (MSS) SYN cookie в пакете SYN-ACK, отправляемом клиенту.

Допустимые значения: 0 и числа от 256 до 9162.

Параметр доступен только в TMOS 13.0.0 и более поздних версиях.

tcp_close_timeout

string

Задает продолжительность простоя соединения до его удаления.

tcp_generate_isn

boolean

Если задано true, система генерирует начальные порядковые номера для пакетов SYN в соответствии с RFC 1948.

Допустимые значения:

  • false
  • true

tcp_handshake_timeout

string

Указывает допустимую продолжительность рукопожатия TCP (максимальное время простоя между синхронизацией (SYN) и подтверждением (ACK) со стороны клиента). Если рукопожатие TCP длится дольше заданного времени ожидания, система автоматически закрывает соединение.

Если задано число, указывает, как долго система может пытаться установить рукопожатие TCP до истечения времени ожидания.

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

Если задано indefinite, время ожидания при попытке установить рукопожатие TCP никогда не истекает.

tcp_strip_sack

boolean

Если задано true, система блокирует передачу параметра TCP selective ACK SackOK на сервер в начальном пакете SYN.

Варианты:

  • false
  • true

tcp_time_wait_timeout

integer

Указывает, сколько миллисекунд соединение находится в состоянии TIME-WAIT перед закрытием.

Этот параметр доступен только в TMOS 13.0.0 и более поздних версиях.

tcp_timestamp_mode

string

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

Варианты:

  • "preserve"
  • "rewrite"
  • "strip"

tcp_wscale_mode

string

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

Варианты:

  • "preserve"
  • "rewrite"
  • "strip"

timeout_recovery

string

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

Ошибки истечения времени ожидания могут быть вызваны DoS-атакой или потерей пакетов в соединении.

Если задано disconnect, система BIG-IP разрывает соединение.

Если задано fallback, соединение возвращается к обычной балансировке нагрузки FastL4 на основе заголовка TCP клиента. В результате система BIG-IP выбирает внутренний сервер только на основе адреса и порта источника.

Варианты:

  • "disconnect"
  • "fallback"

Примечания

Примечание

  • Дополнительные сведения об использовании 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 fastL4 profile
  bigip_profile_fastl4:
    name: foo
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ

Описание

client_timeout

string

Новое значение времени ожидания клиента для ресурса.

Возвращается: при изменении

Пример: "True"

description

string

Новое описание.

Возвращается: при изменении

Пример: "My description"

explicit_flow_migration

boolean

Новое значение параметра миграции потоков.

Возвращается: при изменении

Пример: true

hardware_syn_cookie

boolean

Включает или отключает поддержку аппаратных SYN Cookie при наличии PVA10 в системе.

Возвращается: при изменении

Пример: false

idle_timeout

string

Новое значение времени ожидания простоя.

Возвращается: при изменении

Пример: "123"

ip_df_mode

string

Новое значение флага Don’t Fragment (DF).

Возвращается: при изменении

Пример: "clear"

ip_tos_to_client

string

Новое значение параметра IP ToS для клиента.

Возвращается: при изменении

Пример: "100"

ip_tos_to_server

string

Новое значение параметра IP ToS для сервера.

Возвращается: при изменении

Пример: "100"

ip_ttl_mode

string

Новое значение параметра Time To Live (TTL).

Возвращается: при изменении

Пример: "proxy"

ip_ttl_v4

integer

Новое значение параметра Time To Live (TTL) для IPv4.

Возвращается: при изменении

Пример: 200

ip_ttl_v6

integer

Новое значение параметра Time To Live (TTL) для IPv6.

Возвращается: при изменении

Пример: 200

keep_alive_interval

integer

Новое значение интервала TCP Keep Alive.

Возвращается: при изменении

Пример: 100

late_binding

boolean

Новое значение параметра отложенной привязки.

Возвращается: при изменении

Пример: true

link_qos_to_client

string

Новое значение параметра Link QoS для клиента.

Возвращается: при изменении

Пример: "pass-through"

link_qos_to_server

string

Новое значение параметра Link QoS для сервера.

Возвращается: при изменении

Пример: "123"

loose_close

boolean

Новое значение параметра Loose Close.

Возвращается: при изменении

Пример: false

loose_initialization

boolean

Новое значение параметра Loose Initiation.

Возвращается: при изменении

Пример: false

mss_override

integer

Новое значение параметра переопределения максимального размера сегмента.

Возвращается: при изменении

Пример: 300

pva_acceleration

string

Указывает политику ускорения Packet Velocity ASIC.

Возвращается: при изменении

Пример: "full"

reassemble_fragments

boolean

Новое значение параметра повторной сборки фрагментов IP.

Возвращается: при изменении

Пример: true

receive_window_size

integer

Новое значение окна приёма.

Возвращается: при изменении

Пример: 1024

reset_on_timeout

boolean

Новое значение параметра сброса при истечении времени ожидания.

Возвращается: при изменении

Пример: false

rtt_from_client

boolean

Новое значение параметра RTT от клиента.

Возвращается: при изменении

Пример: false

rtt_from_server

boolean

Новое значение параметра RTT от сервера.

Возвращается: при изменении

Пример: false

server_sack

boolean

Новое значение параметра Server Sack.

Возвращается: при изменении

Пример: true

server_timestamp

boolean

Новое значение параметра временной метки сервера.

Возвращается: при изменении

Пример: true

syn_cookie_enable

boolean

Указывает, использовать ли SYN Cookie.

Возвращается: при изменении

Пример: false

syn_cookie_mss

integer

Новое значение MSS для SYN Cookie.

Возвращается: при изменении

Пример: 1024

tcp_close_timeout

string

Новое значение времени ожидания закрытия TCP.

Возвращается: при изменении

Пример: "100"

tcp_generate_isn

boolean

Новое значение параметра генерации начального порядкового номера.

Возвращается: при изменении

Пример: false

tcp_handshake_timeout

integer

Новое значение времени ожидания рукопожатия TCP.

Возвращается: при изменении

Пример: 5

tcp_strip_sack

boolean

Новое значение параметра Strip Sack OK.

Возвращается: при изменении

Пример: false

tcp_time_wait_timeout

integer

Новое значение времени ожидания состояния TIME-WAIT TCP.

Возвращается: при изменении

Пример: 100

tcp_timestamp_mode

string

Новое значение режима временных меток TCP.

Возвращается: при изменении

Пример: "rewrite"

tcp_wscale_mode

string

Новое значение режима масштабирования окна TCP.

Возвращается: при изменении

Пример: "strip"

timeout_recovery

string

Новое значение параметра восстановления после истечения времени ожидания.

Возвращается: при изменении

Пример: "fallback"

Авторы

  • Tim Rupp (@caphrim007)
  • Wojciech Wypior (@wojtek0806)

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

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

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

Spec-Zone.ru

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