community.network.netscaler_lb_vserver – Управление конфигурацией балансировщика нагрузки vserver
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в книге задач укажите: community.network.netscaler_lb_vserver.
Обзор
- Управление конфигурацией балансировщика нагрузки vserver
- Этот модуль предназначен для выполнения как на контрольном узле ansible, так и на бастионе (jumpserver) с доступом к фактической инстанции 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 на виртуальном сервере балансировки. | |
| dnsprofilename строка | Имя профиля DNS, которое нужно связать с VServer. Свойства профиля DNS будут применяться к операциям, обрабатываемым VServer. Этот параметр действителен только для DNS и DNS-TCP VServer. Минимальная длина = 1 Максимальная длина = 127 | ||
| downstateflush строка |
| Очистить все активные операции, связанные с виртуальным сервером, состояние которого изменяется с UP на DOWN. Не включайте этот параметр для приложений, которые должны завершить свои операции. | |
| hashlength строка | Количество байтов, которые нужно учитывать для значения хеша, используемого в методах балансировки нагрузки URLHASH и DOMAINHASH. Минимальное значение = 1Максимальное значение = 4096 | ||
| healththreshold строка | Пороговое значение в процентах активных служб, ниже которого состояние vserver устанавливается в down. Если этот порог равен 0, состояние vserver будет up, даже если одна связанная служба недоступна. Минимальное значение = 0Максимальное значение = 100 | ||
| httpprofilename строка | Имя профиля HTTP, настройки которого нужно применить к виртуальному серверу. Минимальная длина = 1 Максимальная длина = 127 | ||
| icmpvsrresponse строка |
| Как устройство NetScaler отвечает на запросы ping, полученные для IP-адреса, общего для одного или нескольких виртуальных серверов. Доступные настройки работают следующим образом: * Если для всех виртуальных серверов, которые используют общий IP-адрес, установлено значение PASSIVE, устройство всегда отвечает на запросы ping.* Если для всех виртуальных серверов, которые используют общий IP-адрес, установлено значение ACTIVE, устройство отвечает на запросы ping, если хотя бы один из виртуальных серверов находится в режиме UP. В противном случае устройство не отвечает.* Если для некоторых виртуальных серверов установлено значение ACTIVE, а для других — PASSIVE, устройство отвечает, если хотя бы один виртуальный сервер с настройкой ACTIVE находится в режиме UP. В противном случае устройство не отвечает.Примечание: Этот параметр доступен на уровне виртуального сервера. Аналогичный параметр «ICMP Response» доступен на уровне IP-адреса для 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 Pattern. Может содержать ведущие или хвостовые ненулевые октеты (например, 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 — распределение запросов по очереди независимо от нагрузки. Сервисам можно назначить веса для обеспечения взвешенного распределения при использовании round robin.* 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-адрес подсети (SNIP). Пакеты клиента не изменяются. Применимо как к пакетам 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. Изменение значения на ноль приведет к тому, что службы, которые в настоящее время находятся в режиме постепенного наращивания, получат весь трафик, как определено методом LB. Впоследствии любые новые добавленные службы будут использовать глобальный коэффициент 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* в CLI представлен как 65535 в API NITRO | ||
| processlocal строка |
| Включив этот параметр, пакеты, предназначенные для виртуального сервера в кластере, не будут направляться. Включите этот параметр для режима запроса-ответа с одиночным пакетом или когда устройство upstream выполняет правильную 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 строка |
| Функция маршрутизации ввода-вывода с использованием Health Injection (RHI) устройства NetScaler для рекламы маршрута VIP-адреса, связанного с виртуальным сервером. Когда параметр Уровень RHI VServer (RHI) устанавливается в VSVR_CNTRLD, следующие параметры RHI разные для VIP-адреса на основе настроек RHIstate (состояние RHI) на виртуальных серверах, связанных с VIP-адресом: * Если вы установите rhistate в PASSIVE на всех виртуальных серверах, NetScaler ADC всегда рекламирует маршрут для VIP-адреса.* Если вы установите rhistate в ACTIVE на всех виртуальных серверах, NetScaler ADC рекламирует маршрут для VIP-адреса, если хотя бы один из связанных виртуальных серверов находится в состоянии UP.* Если вы установите rhistate в ACTIVE на некоторых и PASSIVE на других, NetScaler ADC рекламирует маршрут для VIP-адреса, если по крайней мере один из связанных виртуальных серверов, чье rhistate установлено в ACTIVE, находится в состоянии UP. | |
| rtspnat boolean |
| Использовать трансляцию сетевых адресов (NAT) для соединений RTSP-данных. | |
| save_config boolean |
| Если yes, модуль сохранит конфигурацию на узле Netscaler, если внесёт какие-либо изменения.Модуль не сохранит конфигурацию на узле Netscaler, если не внес никаких изменений. | |
| servicebindings string | Список служб вместе с весами, которые балансируются по нагрузке. Доступны следующие подварианты. | ||
| servicename string | Служба для привязки к виртуальному серверу. Минимальная длина = 1 | ||
| weight string | Вес, назначаемый указанной службе. Минимальное значение = 1Максимальное значение = 100 | ||
| servicegroupbindings string | Список групп служб вместе с весами, которые балансируются по нагрузке. Доступны следующие подварианты. | ||
| servicegroupname string | Имя группы служб, привязанной к выбранному виртуальному серверу балансировки нагрузки. | ||
| weight string | Целое число, определяющее вес службы. Большее число указывает больший вес. Определяет емкость службы по отношению к другим службам в конфигурации балансировки нагрузки. Определяет приоритет, предоставляемый службе при принятии решений о балансировке нагрузки. Минимальное значение = 1Максимальное значение = 100 | ||
| servicetype string |
| Протокол, используемый службой (также называемый типом службы). | |
| sessionless string |
| Выполнять балансировку нагрузки на основе каждого пакета без установления сессий. Рекомендуется для балансировки нагрузки серверов систем обнаружения вторжений (IDS) и сценариев с прямым возвратом на сервер (DSR), где информация о сессии не требуется. | |
| skippersistency string |
| Этот аргумент определяет поведение в случае, если служба, выбранная из существующей сессии сохранения, достигла порога. | |
| sobackupaction string |
| Действие, которое должно быть выполнено, если переполнение должно вступить в силу, но нет или не существует резервного цепочки для переполнения. | |
| somethod string |
| Тип порога, превышение которого вызывает переполнение. Доступные параметры работают следующим образом: * CONNECTION - Переполнение происходит, когда количество клиентских соединений превышает порог.* ДИНАМИЧЕСКОЕ СОЕДИНЕНИЕ - Переполнение происходит, когда количество клиентских соединений на виртуальном сервере превышает сумму максимальных настроек клиентов (Макс. клиентов) для привязанных служб. Не указывайте порог переполнения для этого параметра, потому что порог подразумевается параметрами «Макс. клиентов» привязанных служб. * BANDWIDTH - Переполнение происходит, когда пропускная способность, потребляемая входящим и исходящим трафиком виртуального сервера, превышает порог.* HEALTH - Переполнение происходит, когда процент весов служб, которые являются ВКЛЮЧЕННЫМИ, опускается ниже порога. Например, если к виртуальному серверу привязаны службы svc1, svc2 и svc3 с весами 1, 2 и 3, а порог переполнения составляет 50 %, переполнение происходит, если svc1 и svc3 или svc2 и svc3 переходят в состояние ВЫКЛЮЧЕНО.* NONE - Переполнение не происходит. | |
| sopersistence string |
| Если происходит переполнение, поддерживайте сохранение исходного IP-адреса для первичного и резервного виртуальных серверов. | |
| sopersistencetimeout string | Время ожидания сохранения переполнения в минутах. Минимальное значение = 2Максимальное значение = 1440 | ||
| sothreshold string | Порог, при достижении которого происходит переполнение. Укажите целое число для метода переполнения CONNECTION, значение пропускной способности в килобитах в секунду для метода BANDWIDTH (не вводите единицы) или процент для метода HEALTH (не вводите знак процента).Минимальное значение = 1Максимальное значение = 4294967287 | ||
| ssl_certkey string | Имя сертификата ssl, привязанного к этой службе. Сертификат ssl должен уже существовать. Создание сертификата можно выполнить с помощью модуля community.network.netscaler_ssl_certkey. Этот параметр применим только когда servicetype является SSL | ||
| state string |
| Состояние ресурса, настраиваемого модулем на узле Netscaler. При значении «есть» ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении «отсутствует» ресурс будет удален с узла Netscaler. | |
| tcpprofilename string | Имя TCP-профиля, настройки которого должны быть применены к виртуальному серверу. Минимальная длина = 1 Максимальная длина = 127 | ||
| td string | Целое значение, которое однозначно идентифицирует домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, у которого идентификатор равен 0. Минимальное значение = 0Максимальное значение = 4094 | ||
| timeout string | Период времени, в течение которого действует сессия сохранения. Минимальное значение = 0Максимальное значение = 1440 | ||
| tosid string | Идентификатор TOS виртуального сервера. Применимо только в том случае, когда режим перенаправления балансировки нагрузки задан как TOS. Минимальное значение = 1Максимальное значение = 63 | ||
| v6netmasklen string | Количество битов, которые необходимо учитывать в IP-адресе назначения или источника IPv6 для создания хэша, который необходим для методов балансировки нагрузки DESTINATIONIPHASH и SOURCEIPHASH. Минимальное значение = 1Максимальное значение = 128 | ||
| v6persistmasklen string | Маска сохранения для типов сохранения на основе IP для виртуальных серверов IPv6. Минимальное значение = 1Максимальное значение = 128 | ||
| validate_certs boolean |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты. | |
| vipheader string | Имя вставляемого заголовка. По умолчанию имя vip-header. Минимальная длина = 1 | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. на странице 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
community.network.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
community.network.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 словарь | ошибка | Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: {'clttimeout': 'различие. наше: (float) 10.0 другое: (float) 20.0'} |
| loglines список / элементы=строка | всегда | список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, подробно описывающее причину ошибки Пример: Действие не существует |
Авторы
- Георгис Николопулос (@giorgos-nikolopoulos)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/netscaler_lb_vserver_module.html
