netscaler_gslb_service - Управление сущностями gslb-сервиса в Netscaler.
Новая в версии 2.4.
Обзор
- Управление сущностями gslb-сервиса в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| appflowlog |
| Включить протоколирование информации о потоках appflow. | |
| cip |
| В запросе, перенаправляемом в GSLB-сервис, вставить заголовок, хранящий IP-адрес клиента. Вставка заголовка IP-адреса клиента используется при сохранении состояния сайта на основе прокси-сервиса для соединения. | |
| cipheader | Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с опцией Клиентский IP-адрес. Если включена вставка заголовка IP-адреса клиента для сервиса и имя заголовка не указано, NetScaler appliance использует имя, указанное параметром cipHeader в команде set ns param или, в графическом интерфейсе, параметр Заголовок IP-адреса клиента в диалоговом окне Настройка параметров HTTP. Минимальная длина = 1 | ||
| clttimeout | Время бездействия (в секундах), после которого соединение с клиентом закрывается. Применимо, если используется сохранение состояния сайта на основе прокси-сервиса для соединения. Минимальное значение = 0 Максимальное значение = 31536000 | ||
| cnameentry | Каноническое имя GSLB-сервиса. Используется в GSLB на основе CNAME. Минимальная длина = 1 | ||
| comment | Любые комментарии, которые вы хотите связать с GSLB-сервисом. | ||
| downstateflush |
| Очистить все активные транзакции, связанные с GSLB-сервисом, при переходе его состояния с UP на DOWN. Не включайте этот параметр для сервисов, которые должны завершить свои транзакции. Применимо, если используется сохранение состояния сайта на основе прокси-сервиса для соединения. | |
| hashid | Уникальный идентификатор хэша для GSLB-сервиса, используемый методами балансировки нагрузки на основе хэша. Минимальное значение = 1 | ||
| healthmonitor bool |
| Мониторинг состояния GSLB-сервиса. | |
| ipaddress | IP-адрес для GSLB-сервиса. Должен представлять балансировщик нагрузки, коммутатор контента или виртуальный сервер VPN на устройстве NetScaler или IP-адрес другого устройства балансировки нагрузки. | ||
| maxaaausers | Максимальное количество пользователей SSL VPN, которые могут быть одновременно подключены к виртуальному серверу VPN, представляемому этим GSLB-сервисом. GSLB-сервис, количество пользователей которого достигло максимума, не учитывается при принятии решения GSLB, пока количество не опустится ниже максимума. Минимальное значение = 0Максимальное значение = 65535 | ||
| maxbandwidth | Целое число, определяющее максимальную полосу пропускания для сервиса. GSLB-сервис, полоса пропускания которого достигла максимума, не учитывается при принятии решения GSLB, пока ее использование не опустится ниже максимума. | ||
| maxclient | Максимальное количество открытых соединений, которые может поддерживать сервис в любой момент времени. GSLB-сервис, количество подключений которого достигло максимума, не учитывается при принятии решения GSLB, пока количество подключений не опустится ниже максимума. Минимальное значение = 0Максимальное значение = 4294967294 | ||
| monitor_bindings | Связать мониторы с этим gslb-сервисом | ||
| weight | Вес, назначаемый привязке монитора к сервису. Большее число означает больший вес. Вносит вклад в пороговое значение мониторинга, которое определяет состояние сервиса. Минимальное значение = 1Максимальное значение = 100 | ||
| monitor_name | Имя монитора. | ||
| monthreshold | Пороговое значение мониторинга для GSLB-сервиса. Если сумма весов мониторов, привязанных к этому GSLB-сервису и находящихся в состоянии UP, не равна или не больше этого порога, сервис помечается как DOWN. Минимальное значение = 0Максимальное значение = 65535 | ||
| nitro_pass обязательно | Пароль для аутентификации на узле netscaler. | ||
| nitro_protocol |
| Протокол, используемый при доступе к объектам API nitro. | |
| nitro_timeout | Значение по умолчанию: 310 | Время в секундах до появления ошибки таймаута при установлении нового сеанса с Netscaler | |
| nitro_user обязательно | Имя пользователя для аутентификации на узле netscaler. | ||
| nsip обязательно | IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт можно указать с двоеточием (:). Например, 192.168.1.1:555. | ||
| port | Порт, на котором слушает сущность балансировки нагрузки, представленная этим GSLB-сервисом. Минимальное значение = 1 Диапазон 1 - 65535 * в CLI представлен как 65535 в NITRO API | ||
| publicip | Общедоступный IP-адрес, который устройство NAT преобразует в частный IP-адрес GSLB-сервиса. Необязательно. | ||
| publicport | Общедоступный порт, связанный с общедоступным IP-адресом GSLB-сервиса. Порт сопоставляется с частным номером порта сервиса. Применимо для локального GSLB-сервиса. Необязательно. | ||
| save_config bool |
| Если true, модуль сохранит конфигурацию на узле netscaler, если внесены какие-либо изменения. Модуль не сохранит конфигурацию на узле netscaler, если изменений не было. | |
| servername | Имя сервера, на котором размещен GSLB-сервис. Минимальная длина = 1 | ||
| servicename | Имя GSLB-сервиса. Должно начинаться с ASCII-буквенно-цифрового символа или символа подчеркивания _, и может содержать только ASCII-буквенно-цифровые символы, символ подчеркивания _, символ решетки #, точку ., пробел, двоеточие :, символ "@" @, знак равенства =, и дефис - символы. Может быть изменено после создания GSLB-сервиса.Минимальная длина = 1 | ||
| servicetype |
| Тип создаваемого сервиса. | |
| sitename | Имя GSLB-сайта, к которому относится сервис. Минимальная длина = 1 | ||
| sitepersistence |
| Использование сохранения состояния сайта на основе куки. Применимо только к HTTP и SSL GSLB-сервисам. | |
| siteprefix | Префикс сайта. При привязке сервиса к виртуальному GSLB-серверу, GSLB-домен сайта генерируется внутри для каждой пары сервис-домен путем конкатенации префикса сайта сервиса и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации сохранения состояния сайта HTTP-перенаправлением устройство NetScaler перенаправляет запросы GSLB в GSLB-сервисы, используя их домены сайта. | ||
| state |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При absent ресурс будет удален с узла netscaler. | |
| validate_certs | Значение по умолчанию: "yes" | Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверенные сертификаты. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. в https://www.ansible.com/ansible-netscaler.
Примеры
- name: Setup gslb service 2
delegate_to: localhost
register: result
check_mode: "{{ check_mode }}"
netscaler_gslb_service:
operation: present
servicename: gslb-service-2
cnameentry: example.com
sitename: gslb-site-1
Возвращаемые значения
Общие возвращаемые значения документированы здесь, а следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff словарь | ошибка | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. наше: (строка) server1 другое: (строка) server2' } |
| loglines список | всегда | список зарегистрированных сообщений модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, подробно описывающее причину ошибки Пример: Действие не существует |
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. в здесь.
Автор
- Георгий Николопулос (@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.6/modules/netscaler_gslb_service_module.html
