Spec-Zone.ru › Ansible 2.10

community.network.netscaler_lb_vserver – Управление конфигурацией балансировки нагрузки vserver

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

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

Для использования в плейбуке укажите: community.network.netscaler_lb_vserver.

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

Обзор

  • Управление конфигурацией балансировки нагрузки vserver
  • Этот модуль предназначен для работы как на контрольном узле ansible, так и на бастионе (шлюзе), имеющем доступ к фактическому экземпляру netscaler

Требования

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

  • nitro python sdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
appflowlog
строка
    Варианты:
  • enabled
  • disabled
Применить логирование AppFlow к виртуальному серверу.
authentication
булево
    Варианты:
  • no
  • yes
Включить или отключить аутентификацию пользователя.
authenticationhost
строка
Полное доменное имя (FQDN) виртуального сервера аутентификации, на который пользователь должен быть перенаправлен для аутентификации. Убедитесь, что параметр Authentication установлен в значение yes.
Минимальная длина = 3
Максимальная длина = 252
authn401
булево
    Варианты:
  • no
  • yes
Включить или отключить аутентификацию пользователя с помощью ответов HTTP 401.
authnprofile
строка
Имя профиля аутентификации, которое будет использоваться при включенной аутентификации.
authnvsname
строка
Имя виртуального сервера аутентификации, который будет использоваться для аутентификации пользователей.
Минимальная длина = 1
Максимальная длина = 252
backuplbmethod
строка
    Варианты:
  • ROUNDROBIN
  • LEASTCONNECTION
  • LEASTRESPONSETIME
  • SOURCEIPHASH
  • LEASTBANDWIDTH
  • LEASTPACKETS
  • CUSTOMLOAD
Метод резервного балансирования нагрузки. Вступает в действие, если основной метод балансирования нагрузки выходит из строя или не может быть использован.
Допустимо только если основной метод основан на статической близости.
backuppersistencetimeout
строка
Период времени, в течение которого действует резервное сохранение состояния.
Минимальное значение = 2
Максимальное значение = 1440
bypassaaaa
булево
    Варианты:
  • no
  • yes
Если этот параметр включён при разрешении запроса DNS64, запросы AAAA не отправляются на сервер обратного DNS.
cacheable
булево
    Варианты:
  • no
  • yes
Перенаправлять кэшируемые запросы на виртуальный сервер перенаправления кэша. Виртуальный сервер балансирования нагрузки может пересылать запросы только на виртуальный сервер прозрачного перенаправления кэша, у которого есть IP-адрес и порт комбинация *:80, поэтому такой виртуальный сервер перенаправления кэша должен быть настроен на приложении.
clttimeout
строка
Время простоя, в секундах, после которого клиентское соединение закрывается.
Минимальное значение = 0
Максимальное значение = 31536000
comment
строка
Любые комментарии, которые вы хотите связать с виртуальным сервером.
connfailover
строка
    Варианты:
  • DISABLED
  • STATEFUL
  • STATELESS
Режим работы функции переключения соединения для виртуального сервера. После переключения соединения установленные 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
строка
    Варианты:
  • enabled
  • disabled
Включить балансирование нагрузки, специфичное для базы данных, для типов служб MySQL и MSSQL.
disabled
булево
    Варианты:
  • no ←
  • yes
При установке в yes, виртуальный сервер балансировки будет отключён.
При установке в no, виртуальный сервер балансировки будет включён.
Обратите внимание, что из-за ограничений базового API NITRO простое изменение состояния disabled не приводит к тому, что модуль сообщает о смене статуса.
disableprimaryondown
строка
    Варианты:
  • enabled
  • disabled
Если первичный виртуальный сервер выходит из строя, не разрешать ему возвращаться к первичному статусу до его ручного включения.
dns64
строка
    Варианты:
  • enabled
  • disabled
Этот аргумент предназначен для включения/отключения dns64 на lbvserver.
dnsprofilename
строка
Имя профиля DNS, которое должно быть связано с VServer. Свойства профиля DNS будут применяться к транзакциям, обрабатываемым VServer. Этот параметр действителен только для DNS и DNS-TCP VServer.
Минимальная длина = 1
Максимальная длина = 127
downstateflush
строка
    Варианты:
  • enabled
  • disabled
Очистить все активные транзакции, связанные с виртуальным сервером, при переходе его состояния из ВКЛ в ВЫКЛ. Не включайте этот параметр для приложений, которые должны завершить свои транзакции.
hashlength
строка
Количество байтов, которое необходимо учитывать для значения хэша, используемого в методах балансировки нагрузки URLHASH и DOMAINHASH.
Минимальное значение = 1
Максимальное значение = 4096
healththreshold
строка
Пороговое значение в процентах активных служб, ниже которого состояние vserver устанавливается в выкл. Если это пороговое значение равно 0, состояние vserver будет вкл. даже если одна связанная служба вкл.
Минимальное значение = 0
Максимальное значение = 100
httpprofilename
строка
Имя профиля HTTP, настройки которого необходимо применить к виртуальному серверу.
Минимальная длина = 1
Максимальная длина = 127
icmpvsrresponse
строка
    Варианты:
  • PASSIVE
  • ACTIVE
Способ ответа NetScaler appliance на запросы ping, полученные для IP-адреса, который общий для одного или нескольких виртуальных серверов. Доступные настройки работают следующим образом:
* Если параметр установлен в PASSIVE на всех виртуальных серверах, которые разделяют IP-адрес, приложеие всегда отвечает на запросы ping.
* Если параметр установлен в ACTIVE на всех виртуальных серверах, которые разделяют IP-адрес, приложеие отвечает на запросы ping, если хотя бы один из виртуальных серверов находится в состоянии ВКЛ. В противном случае приложеие не отвечает.
* Если параметр установлен в ACTIVE на некоторых виртуальных серверах и PASSIVE на других, приложение отвечает, если хотя бы один виртуальный сервер с параметром ACTIVE находится в состоянии ВКЛ. В противном случае приложение не отвечает.
Примечание: Этот параметр доступен на уровне виртуального сервера. Аналогичный параметр, ICMP Response, доступен на уровне IP-адреса для IPv4-адресов типа VIP. Для установки этого параметра используйте команду add ip в командной строке или диалоговое окно Create IP в графическом интерфейсе.
END_OF_DOCUMENT_MARKER
insertvserveripport
строка
    Варианты:
  • OFF
  • VIPADDR
  • V6TOV4MAPPING
Вставить 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
  • LEASTCONNECTION
  • LEASTRESPONSETIME
  • URLHASH
  • DOMAINHASH
  • DESTINATIONIPHASH
  • SOURCEIPHASH
  • SRCIPDESTIPHASH
  • LEASTBANDWIDTH
  • LEASTPACKETS
  • TOKEN
  • SRCIPSRCPORTHASH
  • LRTM
  • CALLIDHASH
  • CUSTOMLOAD
  • LEASTREQUEST
  • AUDITLOGHASH
  • STATICPROXIMITY
Метод балансировки нагрузки. Доступные настройки работают следующим образом:
* 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
  • MAC
  • IPTUNNEL
  • TOS
Режим перенаправления для балансировки нагрузки. Доступные настройки работают следующим образом:
* 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.
Вы можете использовать либо IPTUNNEL, либо TOS вариант для реализации возврата к прямому серверу (DSR).
macmoderetainvlan
строка
    Варианты:
  • enabled
  • disabled
Этот параметр используется для сохранения информации о VLAN входящего пакета при включенном macmode.
maxautoscalemembers
строка
Максимальное количество членов, ожидаемое при использовании vserver в Autoscale.
Минимальное значение = 0
Максимальное значение = 5000
minautoscalemembers
строка
Минимальное количество членов, ожидаемое при использовании vserver в Autoscale.
Минимальное значение = 0
Максимальное значение = 5000
mssqlserverversion
строка
    Варианты:
  • 70
  • 2000
  • 2000SP1
  • 2005
  • 2008
  • 2008R2
  • 2012
  • 2014
Для виртуального сервера балансировки нагрузки типа MSSQL, версия Microsoft SQL Server. Установите этот параметр, если ожидается, что некоторые клиенты будут использовать версию, отличную от версии базы данных. Эта настройка обеспечивает совместимость между подключениями со стороны клиента и сервера, гарантируя, что вся коммуникация соответствует версии сервера.
mysqlcharacterset
строка
Набор символов, который виртуальный сервер рекламирует клиентам.
mysqlprotocolversion
строка
Версия протокола MySQL, которую виртуальный сервер рекламирует клиентам.
mysqlservercapabilities
строка
Возможности сервера, которые виртуальный сервер рекламирует клиентам.
mysqlserverversion
строка
Строка версии сервера MySQL, которую виртуальный сервер рекламирует клиентам.
Минимальная длина = 1
Максимальная длина = 31
name
строка
Имя виртуального сервера. Должно начинаться с символа ASCII-буквы, цифры или подчеркивания _, и должно содержать только ASCII-буквы, цифры, подчеркивания, знак решётки #, точку ., пробел, двоеточие :, знак «@» @, знак «=» =, и дефис - символы. Может быть изменён после создания виртуального сервера.
Минимальная длина = 1
netmask
строка
Маска подсети IPv4, применяемая к IP-адресу назначения или IP-адресу источника, когда метод балансировки нагрузки - DESTINATIONIPHASH или SOURCEIPHASH.
Минимальная длина = 1
END_OF_DOCUMENT_MARKER
netprofile
строка
Имя сетевого профиля, который необходимо связать с виртуальным сервером. Если вы установили этот параметр, виртуальный сервер будет использовать только IP-адреса в сетевом профиле в качестве IP-адресов источника при установлении подключений с серверами.
Минимальная длина = 1
Максимальная длина = 127
newservicerequest
string
Количество запросов или процент загрузки существующих сервисов, на которое следует увеличить загрузку нового сервиса на каждом интервале в режиме медленного запуска. ненулевое значение указывает, что медленный запуск применим. Ноль указывает, что применяется глобальный параметр запуска RR. Изменение значения на ноль приведет к тому, что сервисы, которые в настоящее время находятся в медленном запуске, будут принимать весь трафик, определяемый методом LB. Впоследствии все новые добавленные сервисы будут использовать глобальный множитель RR.
newservicerequestincrementinterval
string
Интервал в секундах между последовательными увеличениями нагрузки на новый сервис или сервис, состояние которого только что изменилось с DOWN на UP. Значение 0 (ноль) указывает на ручной медленный запуск.
Минимальное значение = 0
Максимальное значение = 3600
newservicerequestunit
string
    Варианты:
  • PER_SECOND
  • PERCENT
Единицы измерения для увеличения нагрузки на каждом интервале в режиме медленного запуска.
nitro_pass
string / обязательно
Пароль для аутентификации на узле Netscaler.
nitro_protocol
string
    Варианты:
  • http ←
  • https
Протокол для доступа к объектам API nitro.
nitro_timeout
float
По умолчанию:
310
Время в секундах до возникновения ошибки таймаута при установлении нового сеанса с Netscaler
nitro_user
string / обязательно
Имя пользователя для аутентификации на узле Netscaler.
nsip
string / обязательно
IP-адрес устройства Netscaler, к которому будут выполняться вызовы API nitro.
Порт можно указать с помощью двоеточия (:). Например, 192.168.1.1:555.
oracleserverversion
string
    Варианты:
  • 10G
  • 11G
Версия сервера Oracle.
persistavpno
string
Номер AVP для сохранения состояния (Diameter Persistency).
В случае, если этот AVP не определен в базовой RFC 3588 и он вложен внутри группированного AVP,
определите последовательность номеров AVP (максимум 3) в порядке от родителя к дочернему элементу.
Скажем, номер AVP сохранения X вложен в AVP Y, который вложен в Z, тогда определите список как Z Y X.
Минимальное значение = 1
persistencebackup
string
    Варианты:
  • SOURCEIP
  • NONE
Тип резервного сохранения состояния для виртуального сервера. Вступает в действие, если первичный механизм сохранения состояния выходит из строя.
persistencetype
string
    Варианты:
  • SOURCEIP
  • COOKIEINSERT
  • SSLSESSION
  • RULE
  • URLPASSIVE
  • CUSTOMSERVERID
  • DESTIP
  • SRCIPDESTIP
  • CALLID
  • RTSPSID
  • DIAMETER
  • FIXSESSION
  • NONE
Тип сохранения состояния для виртуального сервера. Доступные параметры работают следующим образом:
* IP-адрес клиента - Соединения с одного и того же IP-адреса клиента относятся к одному сеансу сохранения состояния.
* HTTP Cookie - Соединения, имеющие одинаковый HTTP Cookie, вставленный директивой Set-Cookie с сервера, относятся к одному сеансу сохранения состояния.
* Сессия SSL - Соединения с одинаковым ID сеанса SSL относятся к одному сеансу сохранения состояния.
* ID сервера - Соединения с одинаковым идентификатором сервера являются частью одного сеанса. Для этого типа сохранения состояния установите параметр ID сервера (CustomServerID) для каждого сервиса и настройте параметр Правило для идентификации ID сервера в запросе.
* Правило - Все соединения, соответствующие заданному правилу, относятся к одному сеансу сохранения состояния.
* ID сервера URL - Запросы с одинаковым ID сервера в запросе URL относятся к одному сеансу сохранения состояния. ID сервера представляет собой шестнадцатеричное представление IP-адреса и порта сервиса, на который необходимо перенаправить запрос. Этот тип сохранения состояния требует правила для идентификации ID сервера в запросе.
* IP-адрес назначения - Соединения с тем же адресом назначения относятся к одному сеансу сохранения состояния.
* Исходный и конечный IP-адрес - Соединения с одинаковым исходным и конечным IP-адресом относятся к одному сеансу сохранения состояния.
* SIP CALL-ID - Соединения с одинаковым заголовком SIP CALL-ID относятся к одному сеансу сохранения состояния.
* RTSP SID - Соединения с одинаковым ID сеанса RTSP относятся к одному сеансу сохранения состояния.
* FIXSESSION - Соединения с одинаковыми значениями SenderCompID и TargetCompID относятся к одному сеансу сохранения состояния.
persistmask
string
Маска сохранения состояния для типов сохранения состояния на основе IP для IPv4 виртуальных серверов.
Минимальная длина = 1
port
string
Номер порта виртуального сервера.
Диапазон 1 - 65535
* в CLI представлен как 65535 в NITRO API
processlocal
string
    Варианты:
  • enabled
  • disabled
Включив этот параметр, пакеты, предназначенные для vserver в кластере, не будут подвергаться перенаправлению. Включите этот параметр для режима запроса-ответа на основе одного пакета или когда upstream устройство выполняет надлежащее RSS для распределения на основе соединения.
push
string
    Варианты:
  • enabled
  • disabled
Обрабатывать трафик с виртуальным сервером push, связанным с этим виртуальным сервером балансировки нагрузки.
pushlabel
string
Выражение для извлечения метки из ответа сервера. Может быть выражением или именем именованного выражения.
pushmulticlients
boolean
    Варианты:
  • no
  • yes
Разрешить множественные подключения Web 2.0 от одного клиента к виртуальному серверу и ожидать обновлений.
pushvserver
string
Имя виртуального сервера балансировки нагрузки типа PUSH или SSL_PUSH, на который сервер отправляет обновления, полученные на виртуальном сервере балансировки нагрузки, который вы настраиваете.
Минимальная длина = 1
range
string
Количество IP-адресов, которые устройство должно сгенерировать и назначить виртуальному серверу. Затем виртуальный сервер функционирует как виртуальный сетевой сервер, принимающий трафик по любому из сгенерированных IP-адресов. IP-адреса генерируются автоматически следующим образом:
* Для диапазона n последний октет адреса, указанного в параметре IP-адрес, увеличивается на n-1 раз.
* Если последний октет превышает 255, он обнуляется, а третий октет увеличивается на 1.
Примечание: Параметр Range назначает несколько IP-адресов одному виртуальному серверу. Чтобы сгенерировать массив виртуальных серверов, каждый из которых владеет только одним IP-адресом, используйте скобки в параметрах IP-адрес и Имя для указания диапазона. Например:
add lb vserver my_vserver[1-3] HTTP 192.0.2.[1-3] 80.
Минимальное значение = 1
Максимальное значение = 254
recursionavailable
boolean
    Варианты:
  • no
  • yes
При установке в положение ДА этот параметр заставляет ответы DNS от этого vserver включать бит RA. Как правило, этот параметр устанавливают в положение ДА, когда vserver балансирует нагрузку на набор DNS-серверов, поддерживающих рекурсивные запросы.
redirectportrewrite
string
    Варианты:
  • enabled
  • disabled
Перезаписать порт и изменить протокол для обеспечения успешного перенаправления HTTP с сервисов.
redirurl
string
URL для перенаправления трафика, если виртуальный сервер недоступен.
ВНИМАНИЕ! Убедитесь, что домен в URL не совпадает с доменом, указанным для политики переключения содержимого. Если это так, запросы постоянно перенаправляются на недоступный виртуальный сервер.
Минимальная длина = 1
resrule
string
Стандартное выражение, определяющее, какую часть ответа сервера использовать для создания сеансов сохранения состояния на основе правил (тип сохранения состояния RULE). Может быть выражением или именем именованного выражения.
Пример:
HTTP.RES.HEADER("setcookie".VALUE(0).TYPECAST_NVLIST_T("=",";").VALUE("server1")).
rhistate
string
    Варианты:
  • PASSIVE
  • ACTIVE
Функциональность Route Health Injection (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
boolean
    Варианты:
  • no
  • yes
Использовать трансляцию сетевых адресов (NAT) для подключений данных RTSP.
save_config
boolean
    Варианты:
  • no
  • yes ←
Если yes, модуль сохранит конфигурацию на узле Netscaler, если внесёт изменения.
Модуль не сохранит конфигурацию на узле Netscaler, если не было внесено никаких изменений.
servicebindings
string
Список служб вместе с весами, которые сбалансированы по нагрузке.
Доступны следующие подварианты.
servicename
string
Служба для привязки к виртуальному серверу.
Минимальная длина = 1
weight
string
Вес, который нужно назначить указанной службе.
Минимальное значение = 1
Максимальное значение = 100
servicegroupbindings
string
Список групп служб вместе с весами, которые сбалансированы по нагрузке.
Доступны следующие подварианты.
servicegroupname
string
Имя группы служб, привязанной к выбранному виртуальному серверу балансировки нагрузки.
weight
string
Целое число, определяющее вес службы. Более высокое число означает больший вес. Определяет ёмкость службы по отношению к другим службам в конфигурации балансировки нагрузки. Определяет приоритет, присваиваемый службе при принятии решений о балансировке нагрузки.
Минимальное значение = 1
Максимальное значение = 100
servicetype
string
    Варианты:
  • HTTP
  • FTP
  • TCP
  • UDP
  • SSL
  • SSL_BRIDGE
  • SSL_TCP
  • DTLS
  • NNTP
  • DNS
  • DHCPRA
  • ANY
  • SIP_UDP
  • SIP_TCP
  • SIP_SSL
  • DNS_TCP
  • RTSP
  • PUSH
  • SSL_PUSH
  • RADIUS
  • RDP
  • MYSQL
  • MSSQL
  • DIAMETER
  • SSL_DIAMETER
  • TFTP
  • ORACLE
  • SMPP
  • SYSLOGTCP
  • SYSLOGUDP
  • FIX
  • SSL_FIX
Протокол, используемый службой (также называется типом службы).
sessionless
string
    Варианты:
  • enabled
  • disabled
Выполнять балансировку нагрузки на основе каждого пакета без установления сессий. Рекомендуется для балансировки нагрузки серверов систем обнаружения вторжений (IDS) и сценариев с прямым возвратом на сервер (DSR), где информация о сессии не требуется.
skippersistency
string
    Варианты:
  • Bypass
  • ReLb
  • None
Этот аргумент определяет поведение в случае, если служба, выбранная из существующей сессии сохранения, достигла порога.
sobackupaction
string
    Варианты:
  • DROP
  • ACCEPT
  • REDIRECT
Действие, которое необходимо выполнить, если переполнение должно вступить в силу, но нет или недоступна резервная цепочка для переполнения.
somethod
string
    Варианты:
  • CONNECTION
  • DYNAMICCONNECTION
  • BANDWIDTH
  • HEALTH
  • NONE
Тип порога, превышение которого запускает переполнение. Доступные настройки работают следующим образом:
* 2 - Переполнение происходит, когда количество клиентских подключений превышает порог.
* DYNAMICCONNECTION - Переполнение происходит, когда количество клиентских подключений на виртуальном сервере превышает сумму максимальных настроек клиентов (Макс. клиенты) для связанных служб. Не указывайте порог переполнения для этой настройки, так как порог подразумевается настройками Max Clients связанных служб.
* 1440 - Переполнение происходит, когда пропускная способность, потребляемая входящим и исходящим трафиком виртуального сервера, превышает порог.
* CONNECTION - Переполнение происходит, когда процент весов служб, которые активны, падает ниже порога. Например, если службы svc1, svc2 и svc3 связаны с виртуальным сервером с весами 1, 2 и 3, а порог переполнения составляет 50%, переполнение происходит, если svc1 и svc3 или svc2 и svc3 переходят в состояние «НЕАКТИВНО».
* BANDWIDTH - Переполнение не происходит.
sopersistence
string
    Варианты:
  • enabled
  • disabled
Если происходит переполнение, сохранять сохранение первичного IP-адреса для виртуальных серверов как для основного, так и для резервного.
sopersistencetimeout
string
Тайм-аут для сохранения переполнения, в минутах.
Минимальное значение = 2
Максимальное значение = 1440
sothreshold
string
Порог, при достижении которого происходит переполнение. Укажите целое число для метода переполнения CONNECTION, значение пропускной способности в килобитах в секунду для метода BANDWIDTH (не вводите единицы измерения) или процент для метода HEALTH (не вводите знак процента).
Минимальное значение = 1
Максимальное значение = 4294967287
ssl_certkey
string
Имя сертификата ssl, привязанного к этой службе.
Сертификат ssl должен уже существовать.
Создание сертификата можно выполнить с помощью модуля community.network.netscaler_ssl_certkey.
Этот параметр применим только в том случае, когда servicetype является 1.
state
string
    Варианты:
  • absent
  • present ←
Состояние ресурса, настраиваемого модулем на узле Netscaler.
При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля.
При значении absent ресурс будет удалён с узла Netscaler.
tcpprofilename
string
Имя TCP-профиля, настройки которого нужно применить к виртуальному серверу.
Минимальная длина = 1
Максимальная длина = 127
td
string
Целое значение, которое уникально идентифицирует домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, у которого идентификатор 0.
Минимальное значение = 0
Максимальное значение = 4094
timeout
string
Период времени, в течение которого действует сессия сохранения.
Минимальное значение = 0
Максимальное значение = 1440
tosid
string
Идентификатор TOS виртуального сервера. Применимо только при установке режима перенаправления балансировки нагрузки на TOS.
Минимальное значение = 1
Максимальное значение = 63
v6netmasklen
string
Количество битов для рассмотрения в IPv6 адресе назначения или источника IP, для создания хэша, который требуется методами балансировки нагрузки DESTINATIONIPHASH и 
# 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
.
Минимальное значение = 1
Максимальное значение = 128
v6persistmasklen
string
Маска сохранения для типов сохранения на основе IP для виртуальных серверов IPv6.
Минимальное значение = 1
Максимальное значение = 128
validate_certs
boolean
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с использованием самозаверяющих сертификатов.
vipheader
string
Имя вставляемого заголовка. Значение по умолчанию — 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
  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
dictionary
failure
Список различий между фактически настроенным объектом и конфигурацией, заданной в модуле

Пример:
{'clttimeout': 'difference. ours: (float) 10.0 other: (float) 20.0'}
loglines
list / elements=string
always
Список сообщений, записанных модулем

Пример:
['message 1', 'message 2']
msg
string
failure
Сообщение, содержащее причину ошибки

Пример:
Действие не существует


Авторы

  • Георгис Николопулос (@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.10/collections/community/network/netscaler_lb_vserver_module.html

Spec-Zone.ru

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