f5networks.f5_modules.bigip_profile_tcp – Управление профилями TCP на BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_profile_tcp.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- Управление профилями TCP на системе BIG-IP. Существует множество профилей TCP, каждый из которых имеет свои настройки по отношению к стандартному
tcpпрофилю. Пользователи этого модуля должны понимать, что многие доступные параметры не имеют значения по умолчанию в модуле. Вместо этого значение по умолчанию устанавливается самой системой BIG-IP, что в большинстве случаев приемлемо.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| delayed_acks boolean |
| Когда yes, система отправляет меньше одного сегмента ACK на каждый полученный сегмент данных.При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | |
| early_retransmit boolean |
| Когда yes, система использует ранние быстрые повторные передачи для сокращения времени восстановления соединений, ограниченных буфером приема или данными пользователя.При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | |
| idle_timeout string | Указывает время простоя соединения (отсутствия трафика), после которого соединение может быть удалено. При создании нового профиля, если этот параметр не указан, удалённое устройство выберет значение по умолчанию, подходящее для профиля, исходя из своего профиля parent. Если указано число, оно обозначает количество секунд, которое TCP-соединение может оставаться в состоянии простоя, прежде чем система удалит его. Если указано 0, или indefinite, система не удаляет TCP-соединения независимо от того, как долго они остаются в состоянии простоя. | ||
| initial_congestion_window_size integer | Устанавливает начальный размер окна дефицита пропускной способности для соединений с этим пунктом назначения. Фактический размер окна равен этому значению, умноженному на MSS для того же соединения. Если установлено 0, система использует значения, указанные в RFC2414.Допустимый диапазон значений: 0 - 16 включительно. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | ||
| initial_receive_window_size integer | Устанавливает начальный размер окна приема для соединений с этим пунктом назначения. Фактический размер окна равен этому значению, умноженному на MSS для того же соединения. Если установлено 0, система использует значение Slow Start.Допустимый диапазон значений: 0 - 16 включительно. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | ||
| ip_tos_to_client string | Указывает уровень L3 Type of Service, который система вставляет в TCP-пакеты, предназначенные для клиентов. Если pass-through, настройка IP ToS остается без изменений.Если mimic, система устанавливает уровень ToS исходящих пакетов на тот же уровень ToS, что и в последнем полученном входящем пакете.Если задано число, оно указывает установку IP ToS, которую система вставляет в заголовок IP-пакета. Допустимый диапазон чисел: 0 - 255 включительно. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | ||
| nagle string |
| При enabled, система применяет алгоритм Nagle для уменьшения количества коротких сегментов в сети.При auto, использование алгоритма Nagle определяется на основе условий сети.Для интерактивных протоколов, таких как Telnet, rlogin или SSH, F5 рекомендует отключить эту настройку в сетях с высокой задержкой для улучшения отзывчивости приложения. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | |
| name string / required | Указывает имя профиля. | ||
| parent string | Указывает профиль, из которого этот профиль наследует настройки. При создании нового профиля, если этот параметр не указан, по умолчанию используется системный профиль tcp. | ||
| partition string | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| provider dictionary добавлен в 1.0.0 f5networks.f5_modules | Объект типа dict, содержащий данные о соединении. | ||
| auth_provider string | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem boolean |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password string / required | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| server string / required | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port integer | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout integer | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку. | ||
| transport string |
| Настраивает транспортное соединение, используемое при подключении к удаленному устройству. | |
| user string / required | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых сайтах с самозаверяющими сертификатами.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| proxy_options boolean |
| Когда yes, система рекламирует опцию, такую как отметка времени, серверу только в том случае, если она была согласована с клиентом.При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | |
| state string |
| Если present, гарантирует, что профиль существует.Если absent, гарантирует, что профиль удален. | |
| syn_rto_base integer | Устанавливает начальный множитель RTO Retransmission TimeOut для повторной передачи SYN в milliseconds. Это значение модифицируется таблицей экспоненциального отката для выбора интервала последующих повторных передач. Допустимый диапазон значений: 0 - 5000 включительно. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | ||
| time_wait_recycle boolean |
| Указывает, что соединения в состоянии TIME-WAIT повторно используются, если получен пакет SYN (указывает запрос на новое соединение). Если no, соединения в состоянии TIME-WAIT остаются неиспользованными в течение определенного времени.При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | |
| time_wait_timeout string добавлен в 1.3.0 f5networks.f5_modules | Указывает количество миллисекунд, в течение которых соединение находится в состоянии TIME-WAIT перед закрытием. Если immediate, система закрывает соединение немедленно после того, как соединение переходит в состояние TIME-WAIT.Если indefinite или 0, система не закрывает TCP-соединения независимо от того, как долго они остаются в состоянии TIME-WAIT.Допустимый диапазон чисел от 0 до 600000 миллисекунд. При создании нового профиля, если этот параметр не указан, используется значение по умолчанию родительского профиля. | ||
Примечания
Примечание
- Дополнительную информацию об использовании 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 TCP profile
bigip_profile_tcp:
name: foo
parent: f5-tcp-progressive
time_wait_recycle: no
idle_timeout: 300
state: present
provider:
user: admin
password: secret
server: lb.mydomain.com
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| delayed_acks boolean | changed | Указывает, отправляет ли система меньше одного ACK-сегмента на каждый принятый сегмент данных. Пример: True |
| early_retransmit boolean | changed | Указывает использование ранних быстрых повторных передач. Пример: True |
| idle_timeout integer | changed | Новый таймаут бездействия ресурса. Пример: 100 |
| initial_congestion_window_size integer | changed | Указывает начальный размер окна перегрузки для подключений к этому пункту назначения. Пример: 5 |
| initial_receive_window_size integer | changed | Указывает начальный размер окна приема для подключений к этому пункту назначения. Пример: 10 |
| ip_tos_to_client string | changed | Указывает уровень L3 Type of Service, который система вставляет в пакеты TCP, предназначенные для клиентов. Пример: mimic |
| nagle string | changed | Указывает использование алгоритма Nagle. Пример: auto |
| parent string | changed | Новый родитель ресурса. Пример: f5-tcp-optimized |
| proxy_options boolean | changed | Указывает, рекламирует ли система согласованные параметры серверу. |
| syn_rto_base integer | changed | Указывает начальный множитель базового времени повторной передачи (Retransmission TimeOut) для повторной передачи SYN. Пример: 2000 |
| time_wait_recycle boolean | changed | Использование повторного подключения в состоянии TIME-WAIT. Пример: True |
| time_wait_timeout string | changed | Указывает количество миллисекунд, в течение которых соединение находится в состоянии TIME-WAIT перед закрытием. Пример: immediate |
Авторы
- 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_tcp_module.html
