Spec-Zone.ru › Ansible 2.10

f5networks.f5_modules.bigip_profile_fastl4 – Управляет профилями Fast L4

Примечание

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

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

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

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

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

Описание

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
client_timeout
строка
Устанавливает таймаут для поздней привязки.
Это предельное время, которое клиент имеет для предоставления данных приложения, необходимых для выбора сервера на бэкенде, то есть максимальное время ожидания системы BIG-IP информации об отправителе и целевом сервере.
Эта информация обычно поступает в начале пакета входа в FIX.
Когда 0, или immediate, не позволяет времени превышать момент первой передачи пакета.
Когда indefinite, отключает ограничение. Это позволяет клиенту неограниченное время для отправки информации об отправителе и целевом сервере.
description
строка
Описание профиля.
explicit_flow_migration
булево
    Варианты:
  • нет
  • да
Указывает, требуется ли квалифицированному соединению с поздней привязкой явное iRule-команда для миграции вниз на аппаратное обеспечение ePVA.
Когда no, соединение с поздней привязкой мигрирует вниз на ePVA сразу после установления соединения на стороне сервера.
Когда yes, этот параметр останавливает автоматическую миграцию в ePVA и требует, чтобы iRule явно инициировал обработку ePVA, вызвав iRule-команду release_flow. Это позволяет автору iRule контролировать, когда соединение использует аппаратное обеспечение ePVA.
hardware_syn_cookie
булево
    Варианты:
  • нет
  • да
Включает или выключает поддержку аппаратного SYN-cookie, когда PVA10 присутствует в системе.
idle_timeout
строка
Устанавливает длительность простоя соединения (без трафика), прежде чем соединение может быть удалено.
При создании нового профиля, если этот параметр не указан, удалённое устройство выберет значение по умолчанию, подходящее для профиля на основе его профиля parent.
Если указано число, указывает количество секунд, в течение которых TCP-соединение может оставаться бездействующим, прежде чем система удалит его.
Когда indefinite, указывает, что система не удаляет TCP-соединения независимо от того, как долго они остаются бездействующими.
Когда 0, или immediate, указывает, что система удаляет соединения сразу же, когда они становятся бездействующими.
ip_df_mode
строка
    Варианты:
  • pmtu
  • preserve
  • set
  • clear
Устанавливает значение бита «Не фрагментировать» (DF) в заголовке IP исходящего TCP-пакета.
Когда pmtu, устанавливает бит DF исходящего заголовка IP на основе настройки IP pmtu.
Когда preserve, устанавливает бит DF заголовка IP исходящего пакета таким же, как и бит DF заголовка IP входящего пакета.
Когда set, устанавливает бит DF заголовка IP исходящего пакета.
Когда clear, очищает бит DF заголовка IP исходящего пакета.
ip_tos_to_client
строка
Для IP-трафика, проходящего через систему к клиентам, указывает, изменяет ли система значение IP type-of-service (ToS) в заголовке IP-пакета.
Может быть числом от 0 до 255 включительно. Когда число, указывает значение IP ToS, которое система вставляет в заголовок IP-пакета.
Когда pass-through, указывает, что значение IP ToS остается неизменным.
Когда mimic, указывает, что система устанавливает уровень ToS исходящих пакетов на тот же уровень ToS, что и у последнего полученного входящего пакета.
ip_tos_to_server
строка
Для IP-трафика, проходящего через систему к серверам на бэкенде, указывает, изменяет ли система значение IP type-of-service (ToS) в заголовке IP-пакета.
Может быть числом от 0 до 255 включительно. Когда число, указывает значение IP ToS, которое система вставляет в заголовок IP-пакета.
Когда pass-through, указывает, что значение IP ToS остается неизменным.
Когда mimic, указывает, что система устанавливает уровень ToS исходящих пакетов на тот же уровень ToS, что и у последнего полученного входящего пакета.
ip_ttl_mode
строка
    Варианты:
  • proxy
  • preserve
  • decrement
  • set
Указывает режим 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).
ip_ttl_v4
целое число
Указывает значение TTL заголовка IP исходящего пакета для IPv4-трафика.
Максимальное значение TTL составляет 255.
ip_ttl_v6
целое число
Указывает значение TTL заголовка IP исходящего пакета для IPv6-трафика.
Максимальное значение TTL составляет 255.
keep_alive_interval
целое число
Указывает интервал зондирования keep-alive в секундах.
late_binding
булево
    Варианты:
  • нет
  • да
Включает интеллектуальный выбор сервера или пула на бэкенде с помощью iRule для выбора.
Включение late_binding на BIG-IP, работающем на TMOS 12.x, требует включения аппаратного синхронизирующего cookie.
link_qos_to_client
строка
Для IP-трафика, проходящего через систему к клиентам, указывает, изменяет ли система значение QoS (качества связи) канала в заголовке IP-пакета.
Значение link QoS определяет приоритет IP-пакета по отношению к другим данным второго уровня.
Можно указать число от 0 (низший приоритет) до 7 (высший приоритет).
Когда число, указывает значение link QoS, которое система вставляет в заголовок IP-пакета.
Когда pass-through, указывает, что значение link QoS остается неизменным.
link_qos_to_server
строка
Для IP-трафика, проходящего через систему к серверам на бэкенде, указывает, изменяет ли система значение QoS (качества связи) канала в заголовке IP-пакета.
Значение link QoS определяет приоритет IP-пакета по отношению к другим данным второго уровня.
Можно указать число от 0 (низший приоритет) до 7 (высший приоритет).
Когда число, указывает значение link QoS, которое система вставляет в заголовок IP-пакета.
Когда pass-through, указывает, что значение link QoS остается неизменным.
loose_close
булево
    Варианты:
  • нет
  • да
Когда yes, указывает, что система закрывает соединение с нестрогим началом, когда система получает первый пакет FIN от клиента или сервера.
loose_initialization
булево
    Варианты:
  • нет
  • да
Когда yes, указывает, что система инициализирует соединение при получении любого TCP-пакета, а не требует пакета SYN для инициализации соединения.
mss_override
целое число
Указывает переопределение максимального размера сегмента (MSS) для соединений на стороне сервера.
Допустимый диапазон от 256 до 9162 или 0 для отключения.
name
строка / обязательно
Указывает имя профиля.
parent
строка
Указывает профиль, из которого этот профиль наследует настройки.
При создании нового профиля, если этот параметр не указан, по умолчанию используется профиль, предоставленный системой fastL4.
partition
строка
По умолчанию:
"Common"
Раздел устройства для управления ресурсами.
provider
словарь
добавлен в 1.0.0 f5networks.f5_modules
Объект словаря, содержащий сведения о соединении.
auth_provider
строка
Настраивает поставщика аутентификации для получения маркеров аутентификации от удалённого устройства.
Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem
булево
    Варианты:
  • нет
  • да
Если 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.
pva_acceleration
строка
добавлено в 1.3.0 f5networks.f5_modules
    Варианты:
  • full
  • dedicated
  • partial
  • none
Указывает политику ускорения с помощью ASIC Packet Velocity.
reassemble_fragments
логическое значение
    Варианты:
  • no
  • yes
Если yes, система собирает фрагменты IP-пакетов.
receive_window_size
целое число
Указывает количество данных, которое система BIG-IP может принять без подтверждения от сервера.
reset_on_timeout
логическое значение
    Варианты:
  • no
  • yes
Если yes, система отправляет пакет reset (RST) в дополнение к удалению соединения, когда соединение превышает значение таймаута бездействия.
rtt_from_client
логическое значение
    Варианты:
  • no
  • yes
Если yes, система использует опции TCP timestamp для измерения времени захода-выхода до клиента.
rtt_from_server
логическое значение
    Варианты:
  • no
  • yes
Если yes, система использует опции TCP timestamp для измерения времени захода-выхода до сервера.
server_sack
логическое значение
    Варианты:
  • no
  • yes
Указывает, обрабатывает ли система BIG-IP пакеты Selective ACK (Sack) в ответах с куки-файлами сервера.
server_timestamp
логическое значение
    Варианты:
  • no
  • yes
Указывает, обрабатывает ли система BIG-IP пакеты запроса времени (timestamp) в ответах с куки-файлами сервера.
state
строка
    Варианты:
  • present ←
  • absent
Если present, гарантирует, что профиль существует.
Если absent, гарантирует, что профиль удалён.
syn_cookie_mss
целое число
Указывает значение, которое переопределяет значение максимального размера сегмента (MSS) куки-файла SYN в пакете SYN-ACK, возвращаемом клиенту.
Допустимые значения: 0 и значения от 256 до 9162.
Параметр доступен только в TMOS 13.0.0 и выше.
tcp_close_timeout
строка
Указывает длительность времени, в течение которого соединение может оставаться бездействующим перед удалением.
tcp_generate_isn
логическое значение
    Варианты:
  • no
  • yes
Если yes, система генерирует начальные последовательные номера для пакетов SYN в соответствии с RFC 1948.
tcp_handshake_timeout
строка
Указывает допустимую продолжительность рукопожатия TCP (максимальное время бездействия между синхронизацией клиента (SYN) и подтверждением клиента (ACK)). Если рукопожатие TCP занимает больше времени, чем тайм-аут, система автоматически закрывает соединение.
При вводе числа, указывает, сколько времени система может пытаться установить рукопожатие TCP, прежде чем истечёт тайм-аут.
Если disabled, система не применяет тайм-аут к рукопожатию TCP.
Если indefinite, попытки рукопожатия TCP никогда не истекают.
tcp_strip_sack
логическое значение
    Варианты:
  • no
  • yes
Если yes, система блокирует прохождение опции TCP selective ACK SackOK серверу при инициации SYN.
tcp_time_wait_timeout
целое число
Указывает количество миллисекунд, в течение которых соединение находится в состоянии TIME-WAIT перед закрытием.
Этот параметр доступен только в TMOS 13.0.0 и более поздних версиях.
tcp_timestamp_mode
строка
    Варианты:
  • preserve
  • rewrite
  • strip
Указывает действие, которое система должна выполнить с отметками времени TCP.
tcp_wscale_mode
строка
    Варианты:
  • preserve
  • rewrite
  • strip
Указывает действие, которое система должна выполнить с окнами TCP.
timeout_recovery
строка
    Варианты:
  • disconnect
  • fallback
Указывает, как обрабатывать ошибки таймаута клиента для Late Binding.
Ошибки таймаута могут быть вызваны атакой DoS или ненадёжным соединением.
Если disconnect, вызывает сброс соединения системой BIG-IP.
Если fallback, возвращает соединение к нормальному балансированию нагрузки FastL4, основанному на заголовке TCP клиента. Это приводит к тому, что BIG-IP выбирает бэкенд-сервер, основываясь только на адресе и порту источника.

Примечания

Примечание

  • Дополнительную информацию об использовании 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
изменённое
Новое описание.

Пример:
Моё описание
explicit_flow_migration
boolean
изменённое
Новое значение параметра миграции потока.

Пример:
True
hardware_syn_cookie
boolean
изменённое
Включает или отключает поддержку аппаратного SYN-куки, если PVA10 присутствует в системе.
idle_timeout
string
изменённое
Новое значение тайм-аута бездействия.

Пример:
123
ip_df_mode
string
изменённое
Новое значение параметра флага "Не фрагментировать" (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) v4.

Пример:
200
ip_ttl_v6
integer
изменённое
Новое значение параметра Time To Live (TTL) v6.

Пример:
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_initialization
boolean
изменённое
Новое значение параметра Свободная инициализация.
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
изменённое
Новое значение параметра Сброс по таймауту.
rtt_from_client
boolean
изменённое
Новое значение параметра RTT от клиента.
rtt_from_server
boolean
изменённое
Новое значение параметра RTT от сервера.
server_sack
boolean
изменённое
Новое значение параметра Server Sack.

Пример:
True
server_timestamp
boolean
изменённое
Новое значение параметра Server Timestamp.

Пример:
True
syn_cookie_mss
integer
изменённое
Новое значение параметра SYN Cookie MSS.

Пример:
1024
tcp_close_timeout
string
изменённое
Новое значение параметра Таймаут закрытия TCP.

Пример:
100
tcp_generate_isn
boolean
изменённое
Новое значение параметра Генерация начального номера последовательности.
tcp_handshake_timeout
integer
изменённое
Новое значение параметра Таймаут рукопожатия TCP.

Пример:
5
tcp_strip_sack
boolean
изменённое
Новое значение параметра Удаление Sack OK.
tcp_time_wait_timeout
integer
изменённое
Новое значение параметра Таймаут состояния TCP Time Wait.

Пример:
100
tcp_timestamp_mode
string
изменённое
Новое значение параметра Режим TCP Timestamp.

Пример:
rewrite
tcp_wscale_mode
string
изменённое
Новое значение параметра Режим масштабирования окна TCP.

Пример:
strip
timeout_recovery
string
изменённое
Новое значение параметра Восстановление после таймаута.

Пример:
fallback


Авторы

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

© 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_fastl4_module.html

Spec-Zone.ru

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