netscaler_lb_vserver - Управление конфигурацией балансировщика нагрузки vserver
Новая версия с 2.4.
Обзор
- Управление конфигурацией балансировщика нагрузки vserver
- Этот модуль предназначен для работы либо на узле управления ansible, либо на бастионе (шлюзе) с доступом к фактической инстанции netscaler
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| appflowlog |
| Применить логирование AppFlow к виртуальному серверу. | |
| authentication |
| Включить или отключить аутентификацию пользователей. | |
| authenticationhost | Полное доменное имя (FQDN) виртуального сервера аутентификации, на который пользователь должен быть перенаправлен для аутентификации. Убедитесь, что параметр Authentication установлен на yes. Минимальная длина = 3 Максимальная длина = 252 | ||
| authn401 |
| Включить или отключить аутентификацию пользователей с ответами HTTP 401. | |
| authnprofile | Имя профиля аутентификации, который будет использоваться при включенной аутентификации. | ||
| authnvsname | Имя виртуального сервера аутентификации, используемого для аутентификации пользователей. Минимальная длина = 1 Максимальная длина = 252 | ||
| backuplbmethod |
| Метод резервного балансирования нагрузки. Вступает в действие, если основной метод балансирования нагрузки выходит из строя или не может быть использован. Доступен только, если основной метод основан на статической близости. | |
| backuppersistencetimeout | Период времени, в течение которого действует резервное сохранение состояния. Минимальное значение = 2
Максимальное значение = 1440
| ||
| bypassaaaa |
| Если этот параметр включен, при разрешении запроса DNS64 запросы AAAA не отправляются на сервер бэкенд-DNS. | |
| cacheable |
| Перенаправлять кешируемые запросы на виртуальный сервер перенаправления кеша. Виртуальный сервер балансировки нагрузки может пересылать запросы только на виртуальный сервер прозрачного перенаправления кеша с IP-адресом и сочетанием порта *:80, поэтому такой виртуальный сервер перенаправления кеша должен быть настроен на приложении. | |
| clttimeout | Время простоя, в секундах, после которого соединение клиента закрывается. Минимальное значение = 0
Максимальное значение = 31536000
| ||
| comment | Любые комментарии, которые вы хотите связать с виртуальным сервером. | ||
| connfailover |
| Режим работы функции переключения соединения для виртуального сервера. После переключения соединения установленные TCP-соединения и потоки UDP-пакетов остаются активными и возобновляются на вторичном приложении. Клиенты остаются подключенными к тем же серверам. Доступные параметры работают следующим образом: * STATEFUL - Первичное устройство обменивается информацией о состоянии со вторичным устройством в реальном времени, что приводит к некоторой нагрузке на вычислительные ресурсы во время работы.* STATELESS - Информация о состоянии не обменивается, и новое первичное устройство пытается воссоздать поток пакетов на основе информации, содержащейся в полученных пакетах.* DISABLED - Переключение соединения не происходит. | |
| cookiename | Используйте этот параметр для указания имени cookie для типа сохранения COOKIE. Он задает имя cookie с максимальной длиной 32 символа. Если не указано, имя cookie генерируется автоматически. | ||
| datalength | Длина токена, который необходимо извлечь из сегмента данных входящего пакета для использования в методе балансировки нагрузки на основе токенов. Длина токена, указанная в байтах, не должна превышать 24 КБ. Применимо к виртуальным серверам типа TCP. Минимальное значение = 1
Максимальное значение = 100
| ||
| dataoffset | Смещение, которое необходимо учитывать при извлечении токена из полезной нагрузки TCP. Применимо к виртуальным серверам типа TCP, использующим метод балансировки нагрузки на основе токенов. Должно находиться в пределах первых 24 КБ полезной нагрузки TCP. Минимальное значение = 0
Максимальное значение = 25400
| ||
| dbprofilename | Имя профиля базы данных, параметры которого должны быть применены к виртуальному серверу. Минимальная длина = 1 Максимальная длина = 127 | ||
| dbslb |
| Включить балансировку нагрузки, специфичную для базы данных, для типов служб MySQL и MSSQL. | |
| disabled |
| При значении yes виртуальный сервер балансировки нагрузки будет отключен.При значении no виртуальный сервер балансировки нагрузки будет включен.Обратите внимание, что из-за ограничений базового API NITRO простое изменение состояния disabled не приводит к изменению статуса в модуле. | |
| disableprimaryondown |
| Если первичный виртуальный сервер выходит из строя, не разрешайте ему возвращаться в первичный статус до его ручного включения. | |
| dns64 |
| Этот аргумент предназначен для включения/отключения dns64 на lbvserver. | |
| dnsprofilename | Имя DNS-профиля, который должен быть связан с виртуальным сервером. Свойства DNS-профиля будут применяться к операциям, обрабатываемым виртуальным сервером. Этот параметр допустим только для виртуальных серверов DNS и DNS-TCP. Минимальная длина = 1 Максимальная длина = 127 | ||
| downstateflush |
| Очистить все активные операции, связанные с виртуальным сервером, состояние которого изменяется с UP на DOWN. Не включайте этот параметр для приложений, которые должны завершить свои операции. | |
| hashlength | Количество байтов для определения значения хэша, используемого в методах балансировки нагрузки URLHASH и DOMAINHASH. Минимальное значение = 1
Максимальное значение = 4096
| ||
| healththreshold | Пороговое значение в процентах активных сервисов, ниже которого состояние виртуального сервера переводится в DOWN. Если это пороговое значение равно 0, состояние виртуального сервера будет UP даже если один из связанных сервисов находится в состоянии UP. Минимальное значение = 0
Максимальное значение = 100
| ||
| httpprofilename | Имя HTTP-профиля, параметры которого должны быть применены к виртуальному серверу. Минимальная длина = 1 Максимальная длина = 127 | ||
| icmpvsrresponse |
| Способ, которым NetScaler-приложение отвечает на запросы пинга, полученные для IP-адреса, который общий для одного или нескольких виртуальных серверов. Доступные параметры работают следующим образом: * Если параметр установлен в PASSIVE на всех виртуальных серверах, которые используют этот IP-адрес, устройство всегда отвечает на запросы пинга.* Если параметр установлен в ACTIVE на всех виртуальных серверах, которые используют этот IP-адрес, устройство отвечает на запросы пинга, если хотя бы один из виртуальных серверов находится в состоянии UP. В противном случае устройство не отвечает.* Если параметр установлен в ACTIVE на некоторых виртуальных серверах и в PASSIVE на других, устройство отвечает, если хотя бы один виртуальный сервер с параметром ACTIVE находится в состоянии UP. В противном случае устройство не отвечает.Примечание: Этот параметр доступен на уровне виртуального сервера. Аналогичный параметр, Ответ ICMP, доступен на уровне IP-адреса для IPv4-адресов типа VIP. Для настройки этого параметра используйте команду add ip в командной строке или диалоговое окно «Создать IP» в графическом интерфейсе. | |
| insertvserveripport |
| Вставить HTTP-заголовок, значение которого — IP-адрес и номер порта виртуального сервера, перед пересылкой запроса на сервер. Формат заголовка: <vipHeader>: <IP-адрес виртуального сервера>_<номер порта>, где vipHeader — имя заголовка, которое вы указываете. Если у виртуального сервера IPv6-адрес, адрес в заголовке заключен в скобки ([ и ]) для отделения от номера порта. Если вы сопоставили IPv4-адрес с IPv6-адресом виртуального сервера, значение этого параметра определяет, какой IP-адрес вставляется в заголовок следующим образом: * VIPADDR - Вставить IP-адрес виртуального сервера в HTTP-заголовок независимо от того, имеет ли виртуальный сервер IPv4-адрес или IPv6-адрес. Сопоставленный IPv4-адрес, если он настроен, игнорируется.* V6TOV4MAPPING - Вставить IPv4-адрес, сопоставленный с IPv6-адресом виртуального сервера. Если сопоставленный IPv4-адрес не настроен, вставляется IPv6-адрес.* OFF - Отключить вставку заголовка. | |
| ipmask | IP-маска в формате точка-десятичная нотация для параметра IP-шаблон. Может содержать ведущие или хвостовые ненулевые октеты (например, 255.255.240.0 или 0.0.255.255). Соответственно, маска определяет, какие первые n биты или последние n биты целевого IP-адреса в запросе клиента должны быть сопоставлены с соответствующими битами в IP-шаблоне. Первый вариант называется прямой маской. Второй - обратной маской. | ||
| ippattern | Шаблон IP-адреса, в точечной десятичной нотации, для идентификации пакетов, которые должны быть приняты виртуальным сервером. Параметр IP Mask определяет, какая часть IP-адреса назначения сопоставляется с шаблоном. Взаимоисключительно с параметром IP Address. Например, если шаблон IP, назначенный виртуальному серверу, равен 198.51.100.0 и маска IP равна 255.255.240.0 (прямая маска), то первые 20 бит в IP-адресах назначения сопоставляются с первыми 20 битами в шаблоне. Виртуальный сервер принимает запросы с IP-адресами, которые находятся в диапазоне от 198.51.96.1 до 198.51.111.254. Также можно использовать шаблон, такой как 0.0.2.2 и маску, такую как 0.0.255.255 (обратная маска).Если IP-адрес назначения соответствует более чем одному шаблону IP, выбирается шаблон с самым длинным соответствием, и связанный виртуальный сервер обрабатывает запрос. Например, если виртуальные серверы vs1 и vs2 имеют одинаковый шаблон IP, 0.0.100.128, но разные маски IP 0.0.255.255 и 0.0.224.255, IP-адрес назначения 198.51.100.128 имеет самое длинное соответствие с шаблоном IP vs1. Если IP-адрес назначения соответствует двум или более виртуальным серверам в равной степени, запрос обрабатывается виртуальным сервером, номер порта которого соответствует номеру порта в запросе. | ||
| ipv46 | IP-адрес IPv4 или IPv6, который необходимо назначить виртуальному серверу. | ||
| l2conn |
| Использовать параметры уровня 2 (номер канала, MAC-адрес и идентификатор VLAN) в дополнение к 4-кортежу (<IP-адрес источника>:<порт источника>::<IP-адрес назначения>:<порт назначения>), который используется для идентификации соединения. Позволяет нескольким TCP- и не-TCP-соединениям с одинаковым 4-кортежем сосуществовать на устройстве NetScaler. | |
| lbmethod |
| Метод балансировки нагрузки. Доступные настройки работают следующим образом: * ROUNDROBIN - Распределять запросы по очереди, независимо от нагрузки. Весам могут быть назначены сервисы для обеспечения взвешенного распределения по круговой очереди.* LEASTCONNECTION (по умолчанию) - Выбирать сервис с наименьшим количеством подключений.* LEASTRESPONSETIME - Выбирать сервис с наименьшим средним временем отклика.* LEASTBANDWIDTH - Выбирать сервис, который в настоящее время обрабатывает наименьший объем трафика.* LEASTPACKETS - Выбирать сервис, который в настоящее время обслуживает наименьшее количество пакетов в секунду.* CUSTOMLOAD - Базировать выбор сервиса на метриках SNMP, полученных с помощью пользовательских мониторов нагрузки.* LRTM - Выбирать сервис с наименьшим временем отклика. Времена отклика определяются с помощью зондирования мониторинга. Этот метод также учитывает количество активных подключений.Также доступны ряд методов хеширования, в которых устройство извлекает предварительно определенную часть запроса, создает хеш этой части и затем проверяет, были ли какие-либо предыдущие запросы с таким же значением хеша. Если находится соответствие, запрос перенаправляется на сервис, который обслуживал эти предыдущие запросы. Ниже приведены методы хеширования: * URLHASH - Создать хеш URL-адреса запроса (или части URL).* DOMAINHASH - Создать хеш имени домена в запросе (или части имени домена). Имя домена берется из URL-адреса или заголовка Host. Если имя домена присутствует в обоих местах, предпочтение отдается URL-адресу. Если запрос не содержит имени домена, метод балансировки нагрузки по умолчанию LEASTCONNECTION. * DESTINATIONIPHASH - Создать хеш IP-адреса назначения в заголовке IP.* SOURCEIPHASH - Создать хеш IP-адреса источника в заголовке IP.* TOKEN - Извлечь токен из запроса, создать хеш токена и выбрать сервис, которому были отправлены все предыдущие запросы с таким же значением хеша токена.* SRCIPDESTIPHASH - Создать хеш строки, полученной путем конкатенации IP-адреса источника и IP-адреса назначения в заголовке IP.* SRCIPSRCPORTHASH - Создать хеш IP-адреса источника и порта источника в заголовке IP.* CALLIDHASH - Создать хеш заголовка SIP Call-ID. | |
| listenpolicy | Выражение по умолчанию, определяющее трафик, принимаемый виртуальным сервером. Может быть выражением (например, CLIENT.IP.DST.IN_SUBNET(192.0.2.0/24) или именем именованного выражения. В приведенном выше примере виртуальный сервер принимает все запросы, IP-адрес назначения которых находится в подсети 192.0.2.0/24. | ||
| listenpriority | Целое число, определяющее приоритет политики прослушивания. Большее число указывает меньший приоритет. Если запрос соответствует политике прослушивания более чем одного виртуального сервера, виртуальный сервер с политикой прослушивания наивысшего приоритета (наименьший номер приоритета) принимает запрос. Минимальное значение = 0
Максимальное значение = 101
| ||
| m |
| Режим перенаправления для балансировки нагрузки. Доступные настройки работают следующим образом: * IP - Перед пересылкой запроса на сервер изменить IP-адрес назначения на IP-адрес сервера.* MAC - Перед пересылкой запроса на сервер изменить MAC-адрес назначения на MAC-адрес сервера. IP-адрес назначения не изменяется. Режим перенаправления на основе MAC используется в основном в развертываниях балансировки нагрузки с файрволом.* IPTUNNEL - Выполнить инкапсуляцию IP-в-IP для пакетов IP клиента. В внешних заголовках IP установить IP-адрес назначения на IP-адрес сервера и IP-адрес источника на IP-адрес подсети (SNIP). Пакеты IP клиента не изменяются. Применимо к пакетам IPv4 и IPv6.* TOS - Кодировать идентификатор TOS виртуального сервера в поле TOS заголовка IP.Для реализации Direct Server Return (DSR) можно использовать либо IPTUNNEL, либо TOS, вариант. | |
| macmoderetainvlan |
| Этот параметр используется для сохранения информации о VLAN входящего пакета при включенном macmode. | |
| maxautoscalemembers | Максимальное количество членов, ожидаемое при использовании vserver в Autoscale. Минимальное значение = 0
Максимальное значение = 5000
| ||
| minautoscalemembers | Минимальное количество членов, ожидаемое при использовании vserver в Autoscale. Минимальное значение = 0
Максимальное значение = 5000
| ||
| mssqlserverversion |
| Для виртуального сервера балансировки нагрузки типа MSSQL, версия Microsoft SQL Server. Установите этот параметр, если ожидается, что некоторые клиенты будут работать с версией, отличной от версии базы данных. Эта настройка обеспечивает совместимость между соединениями на стороне клиента и сервера, гарантируя, что все коммуникации соответствуют версии сервера. | |
| mysqlcharacterset | Набор символов, который виртуальный сервер объявляет клиентам. | ||
| mysqlprotocolversion | Версия протокола MySQL, объявляемая виртуальным сервером клиентам. | ||
| mysqlservercapabilities | Возможности сервера, объявляемые виртуальным сервером клиентам. | ||
| mysqlserverversion | Строка версии сервера MySQL, объявляемая виртуальным сервером клиентам. Минимальная длина = 1 Максимальная длина = 31 | ||
| name | Имя виртуального сервера. Должно начинаться с ASCII буквенно-цифрового или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания, решетки #, точки ., пробелы, двоеточия :, знаки «@» @, знаки равенства =, и дефисы -. Может быть изменено после создания виртуального сервера.Минимальная длина = 1 | ||
| netmask | Маска подсети IPv4, применяемая к IP-адресу назначения или IP-адресу источника, когда метод балансировки нагрузки DESTINATIONIPHASH или SOURCEIPHASH. Минимальная длина = 1 | ||
| netprofile | Имя сетевого профиля, который необходимо ассоциировать с виртуальным сервером. Если вы установите этот параметр, виртуальный сервер будет использовать только IP-адреса в сетевом профиле в качестве IP-адресов источника при установлении соединений с серверами. Минимальная длина = 1 Максимальная длина = 127 | ||
| newservicerequest | Количество запросов или процент нагрузки на существующие сервисы, на которое нужно увеличить нагрузку на новый сервис на каждом интервале в режиме постепенного запуска. ненулевое значение указывает, что постепенный запуск применимо. Ноль указывает, что применяется глобальный параметр запуска по круговой очереди. Изменение значения на ноль приведет к тому, что сервисы, которые в настоящее время находятся в режиме постепенного запуска, получат весь трафик, как определено методом балансировки нагрузки. Впоследствии все новые добавленные сервисы будут использовать глобальный коэффициент RR. | ||
| newservicerequestincrementinterval | Интервал в секундах между последовательными увеличениями нагрузки на новый сервис или сервис, состояние которого только что изменилось с DOWN на UP. Значение 0 (ноль) указывает ручной постепенный запуск. Минимальное значение = 0
Максимальное значение = 3600
| ||
| newservicerequestunit |
| Единицы, в которых необходимо увеличивать нагрузку на каждом интервале в режиме постепенного запуска. | |
| nitro_pass обязательно | Пароль для аутентификации на узле Netscaler. | ||
| nitro_protocol |
| Протокол для доступа к объектам API Nitro. | |
| nitro_timeout | По умолчанию: 310 | Время в секундах до истечения времени ожидания при установлении нового сеанса с Netscaler | |
| nitro_user обязательно | Имя пользователя для аутентификации на узле Netscaler. | ||
| nsip обязательно | IP-адрес устройства Netscaler, на котором будут выполняться вызовы API Nitro. Порт может быть указан с двоеточием (:). Например, 192.168.1.1:555. | ||
| oracleserverversion |
| Версия сервера Oracle. | |
| persistavpno | Номер AVP для сохранения состояния (Diameter Persistency). В случае, если этот AVP не определен в базовом RFC 3588 и вложен в группированный AVP, определите последовательность номеров AVP (макс. 3) в порядке от родительского к дочернему. Скажем, номер AVP сохранения X вложен в AVP Y, который вложен в Z, тогда список должен быть Z Y X. Минимальное значение = 1
| ||
| persistencebackup |
| Тип резервного сохранения состояния для виртуального сервера. Используется при отказе основного механизма сохранения состояния. | |
| persistencetype |
| Тип сохранения состояния для виртуального сервера. Доступные настройки работают следующим образом: * SOURCEIP - Соединения от одного и того же клиента с одинаковым IP-адресом принадлежат одному сеансу сохранения состояния.* COOKIEINSERT - Соединения с одинаковым HTTP Cookie, вставленным директивой Set-Cookie сервером, принадлежат одному сеансу сохранения состояния.* SSLSESSION - Соединения с одинаковым идентификатором SSL-сессии принадлежат одному сеансу сохранения состояния.* CUSTOMSERVERID - Соединения с одинаковым идентификатором сервера являются частью одного сеанса. Для этого типа сохранения состояния установите параметр Идентификатор сервера (CustomServerID) для каждого сервиса и настройте параметр Правило для идентификации идентификатора сервера в запросе.* RULE - Все соединения, соответствующие определенному правилу, принадлежат одному сеансу сохранения состояния.* URLPASSIVE - Запросы с одинаковым идентификатором сервера в запросе URL принадлежат одному сеансу сохранения состояния. Идентификатор сервера представляет собой шестнадцатеричное представление IP-адреса и порта сервиса, которому необходимо перенаправить запрос. Для этого типа сохранения состояния требуется правило для идентификации идентификатора сервера в запросе.* DESTIP - Соединения с одинаковым IP-адресом назначения принадлежат одному сеансу сохранения состояния.* SRCIPDESTIP - Соединения с одинаковым IP-адресом источника и IP-адресом назначения принадлежат одному сеансу сохранения состояния.* CALLID - Соединения с одинаковым SIP-заголовком CALL-ID принадлежат одному сеансу сохранения состояния.* RTSPSID - Соединения с одинаковым идентификатором сессии RTSP принадлежат одному сеансу сохранения состояния.* FIXSESSION - Соединения с одинаковыми значениями SenderCompID и TargetCompID принадлежат одному сеансу сохранения состояния. | |
| persistmask | Маска сохранения состояния для типов сохранения состояния на основе IP, для виртуальных серверов IPv4. Минимальная длина = 1 | ||
| port | Номер порта виртуального сервера. Диапазон 1 - 65535
* в командной строке представлен как 65535 в API NITRO | ||
| processlocal |
| Включив этот параметр, пакеты, предназначенные для виртуального сервера в кластере, не будут направляться. Включите эту опцию для режима запроса-ответа на основе одного пакета или когда конечное устройство выполняет надлежащее RSS для распределения на основе соединения. | |
| push |
| Обрабатывать трафик с виртуальным сервером push, привязанным к этому виртуальному серверу балансировки нагрузки. | |
| pushlabel | Выражение для извлечения метки из ответа сервера. Может быть либо выражением, либо именем именованного выражения. | ||
| pushmulticlients |
| Разрешить несколько подключений Web 2.0 от одного клиента к виртуальному серверу и ожидать обновлений. | |
| pushvserver | Имя виртуального сервера балансировки нагрузки типа PUSH или SSL_PUSH, на который сервер отправляет обновления, полученные на виртуальном сервере балансировки нагрузки, который вы настраиваете. Минимальная длина = 1 | ||
| range | Количество IP-адресов, которое устройство должно сгенерировать и назначить виртуальному серверу. Затем виртуальный сервер функционирует как виртуальный сетевой сервер, принимая трафик по любому из сгенерированных IP-адресов. IP-адреса генерируются автоматически, следующим образом: * Для диапазона n последний октет адреса, указанного параметром IP-адрес, увеличивается на n-1 раз. * Если последний октет превышает 255, он переходит в 0, а третий октет увеличивается на 1. Примечание: Параметр Диапазон назначает несколько IP-адресов одному виртуальному серверу. Для генерации массива виртуальных серверов, каждый из которых владеет только одним IP-адресом, используйте скобки в параметрах IP-адрес и Имя для указания диапазона. Например: add lb vserver my_vserver[1-3] HTTP 192.0.2.[1-3] 80. Минимальное значение = 1
Максимальное значение = 254
| ||
| recursionavailable |
| Если установлено значение ДА, этот параметр приводит к тому, что в ответах DNS от этого виртуального сервера устанавливается бит RA. Как правило, этот параметр устанавливают в значение ДА, когда виртуальный сервер балансирует набор DNS-серверов, поддерживающих рекурсивные запросы. | |
| redirectportrewrite |
| Переписать порт и изменить протокол для обеспечения успешного перенаправления HTTP с сервисов. | |
| redirurl | URL, на который перенаправить трафик, если виртуальный сервер станет недоступен. ПРЕДУПРЕЖДЕНИЕ! Убедитесь, что домен в URL не совпадает с доменом, указанным для политики переключения содержимого. Если это так, запросы постоянно перенаправляются на недоступный виртуальный сервер. Минимальная длина = 1 | ||
| resrule | Стандартное синтаксическое выражение, указывающее, какую часть ответа сервера использовать для создания сеансов сохранения состояния на основе правил (тип сохранения состояния RULE). Может быть либо выражением, либо именем именованного выражения. Пример: HTTP.RES.HEADER("setcookie".VALUE(0).TYPECAST_NVLIST_T('=',';').VALUE("server1")). | ||
| rhistate |
| Функциональность маршрутизации здоровья впрыска (RHI) устройства NetSaler для объявления маршрута IP-адреса VIP, связанного с виртуальным сервером. Когда параметр Уровень RHI Vserver (RHI) устанавливается в значение VSVR_CNTRLD, следующие различные поведения RHI для IP-адреса VIP в зависимости от настроек RHIstate (RHI STATE) на виртуальных серверах, связанных с IP-адресом VIP: * Если вы установите rhistate в значение PASSIVE на всех виртуальных серверах, NetScaler ADC всегда объявляет маршрут для IP-адреса VIP.* Если вы установите rhistate в значение ACTIVE на всех виртуальных серверах, NetScaler ADC объявляет маршрут для IP-адреса VIP, если хотя бы один из связанных виртуальных серверов находится в состоянии UP.* Если вы установите rhistate в значение ACTIVE на некоторых и PASSIVE на других, NetScaler ADC объявляет маршрут для IP-адреса VIP, если хотя бы один из связанных виртуальных серверов, чья rhistate установлена в ACTIVE, находится в состоянии UP. | |
| rtspnat |
| Использовать трансляцию сетевых адресов (NAT) для соединений данных RTSP. | |
| save_config |
| Если значение true, модуль сохранит конфигурацию на узле Netscaler, если внесены какие-либо изменения. Модуль не сохранит конфигурацию на узле Netscaler, если изменения не были внесены. | |
| servicebindings | Список служб вместе с весами, которые балансируются. Доступны следующие подварианты. | ||
| servicename | Служба, которая должна быть привязана к виртуальному серверу. Минимальная длина = 1 | ||
| weight | Вес, который необходимо назначить указанной службе. Минимальное значение = 1
Максимальное значение = 100
| ||
| servicegroupbindings | Список групп служб вместе с весами, которые балансируются. Доступны следующие подварианты. | ||
| servicegroupname | Имя группы служб, привязанной к выбранному виртуальному серверу балансировки нагрузки. | ||
| вес | Целое число, определяющее вес службы. Большее значение указывает на больший вес. Определяет емкость службы по отношению к другим службам в конфигурации балансировки нагрузки. Определяет приоритет службы при принятии решений о балансировке нагрузки. Минимальное значение = 1
Максимальное значение = 100
| ||
| тип_службы |
| Протокол, используемый службой (также называемый типом службы). | |
| бессессионный |
| Выполнять балансировку нагрузки для каждого пакета без установления сессий. Рекомендуется для балансировки нагрузки серверов систем обнаружения вторжений (IDS) и сценариев с прямым возвратом сервера (DSR), где информация о сессиях не требуется. | |
| skippersistency |
| Этот аргумент определяет поведение в случае, если служба, выбранная из существующей сессии с сохранением состояния, достигла порога. | |
| sobackupaction |
| Действие, которое должно быть выполнено, если переполнение должно вступить в силу, но нет или не существует резервной цепочки для переполнения. | |
| somethod |
| Тип порога, превышение которого инициирует переполнение. Доступные настройки функционируют следующим образом: * CONNECTION - Переполнение происходит, когда количество подключений клиентов превышает порог.* ДИНАМИЧЕСКОЕ_СОЕДИНЕНИЕ - Переполнение происходит, когда количество подключений клиентов на виртуальном сервере превышает сумму максимальных значений настроек клиентов (Макс. клиенты) для привязанных служб. Не указывайте порог переполнения для этой настройки, поскольку порог подразумевается настройками Max Clients привязанных служб. * BANDWIDTH - Переполнение происходит, когда пропускная способность, потребляемая входящим и исходящим трафиком виртуального сервера, превышает порог.* HEALTH - Переполнение происходит, когда процент весов служб, которые являются ВКЛЮЧЕННЫМИ, падает ниже порога. Например, если службы svc1, svc2 и svc3 связаны с виртуальным сервером с весами 1, 2 и 3, а порог переполнения составляет 50%, переполнение происходит, если svc1 и svc3 или svc2 и svc3 переходят в состояние ВЫКЛЮЧЕНО.* NONE - Переполнение не происходит. | |
| sopersistence |
| Если происходит переполнение, сохранить сохранение состояния на основе исходного IP-адреса для виртуальных серверов основного и резервного типов. | |
| sopersistencetimeout | Таймаут для сохранения состояния переполнения в минутах. Минимальное значение = 2
Максимальное значение = 1440
| ||
| sothreshold | Порог, при достижении которого происходит переполнение. Укажите целое число для метода переполнения CONNECTION, значение пропускной способности в килобитах в секунду для метода BANDWIDTH (не вводить единицы) или процент для метода HEALTH (не вводить знак процента).Минимальное значение = 1
Максимальное значение = 4294967287
| ||
| ssl_certkey | Имя сертификата SSL, привязанного к этой службе. Сертификат SSL должен уже существовать. Создание сертификата можно выполнить с помощью модуля netscaler_ssl_certkey. Этот параметр применим только в случае, если servicetype равен SSL. | ||
| состояние |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении присутствует ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении отсутствует ресурс будет удален с узла netscaler. | |
| tcpprofilename | Имя профиля TCP, настройки которого должны быть применены к виртуальному серверу. Минимальная длина = 1 Максимальная длина = 127 | ||
| td | Целое значение, уникально идентифицирующее домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, который имеет идентификатор 0. Минимальное значение = 0
Максимальное значение = 4094
| ||
| таймаут | Период времени, в течение которого действует сессия сохранения состояния. Минимальное значение = 0
Максимальное значение = 1440
| ||
| tosid | Идентификатор TOS виртуального сервера. Применимо только в том случае, если режим перенаправления балансировки нагрузки установлен на TOS. Минимальное значение = 1
Максимальное значение = 63
| ||
| v6netmasklen | Количество битов для рассмотрения в IPv6 адресе назначения или источнике IP-адреса для создания хэша, который требуется методами балансировки нагрузки DESTINATIONIPHASH и SOURCEIPHASH.Минимальное значение = 1
Максимальное значение = 128
| ||
| v6persistmasklen | Маска сохранения состояния для типов сохранения состояния на основе IP-адреса для виртуальных серверов IPv6. Минимальное значение = 1
Максимальное значение = 128
| ||
| validate_certs | По умолчанию: да | Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. | |
| vipheader | Имя вставляемого заголовка. По умолчанию имя vip-header. Минимальная длина = 1 | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами сети Citrix NetScaler см. в https://www.ansible.com/ansible-netscaler.
Примеры
# Netscaler services service-http-1, service-http-2 must have been already created with the netscaler_service module
- name: Create a load balancing vserver bound to services
delegate_to: localhost
netscaler_lb_vserver:
nsip: 172.18.0.2
nitro_user: nsroot
nitro_pass: nsroot
validate_certs: no
state: present
name: lb_vserver_1
servicetype: HTTP
timeout: 12
ipv46: 6.93.3.3
port: 80
servicebindings:
- servicename: service-http-1
weight: 80
- servicename: service-http-2
weight: 20
# Service group service-group-1 must have been already created with the netscaler_servicegroup module
- name: Create load balancing vserver bound to servicegroup
delegate_to: localhost
netscaler_lb_vserver:
nsip: 172.18.0.2
nitro_user: nsroot
nitro_pass: nsroot
validate_certs: no
state: present
name: lb_vserver_2
servicetype: HTTP
ipv46: 6.92.2.2
port: 80
timeout: 10
servicegroupbindings:
- servicegroupname: service-group-1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| diff dict | неудача | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: {'clttimeout': 'различие. наше: (float) 10.0 другое: (float) 20.0'} |
| loglines list | всегда | Список сообщений журнала, созданных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg str | неудача | Сообщение, описывающее причину неудачи Пример: Действия не существует |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимым.
Автор
- George Nikolopoulos (@giorgos-nikolopoulos)
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/netscaler_lb_vserver_module.html
