community.network.netscaler_gslb_service – Управление сущностями gslb-сервиса в Netscaler.

Примечание

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

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

Чтобы использовать его в книге задач, укажите: community.network.netscaler_gslb_service.

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

Описание

Управление сущностями gslb-сервиса в Netscaler.

Требования

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

nitro python sdk

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
appflowlog строка		Варианты: enabled disabled	Включить протоколирование информации о потоках appflow.
cip строка		Варианты: enabled disabled	В запросе, перенаправленном службе GSLB, вставить заголовок, хранящий IP-адрес клиента. Вставка заголовка IP-адреса клиента используется при персистенции сайта на основе прокси-сервера соединения.
cipheader строка			Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с опцией Клиентский IP-адрес. Если вставка заголовка IP-адреса клиента включена на службе и имя для заголовка не указано, NetScaler устройство использует имя, указанное параметром cipHeader в команде set ns param или, в графическом интерфейсе, параметром Заголовок IP-адреса клиента в диалоговом окне Настройка параметров HTTP. Минимальная длина = 1
clttimeout строка			Время бездействия в секундах, после которого соединение с клиентом закрывается. Применимо, если используется персистенция сайта на основе прокси-сервера соединения. Минимальное значение = 0 Максимальное значение = 31536000
cnameentry строка			Каноническое имя службы GSLB. Используется в GSLB на основе CNAME. Минимальная длина = 1
comment строка			Любые комментарии, которые вы хотите связать со службой GSLB.
downstateflush строка		Варианты: enabled disabled	Очистить все активные транзакции, связанные со службой GSLB, когда её состояние переходит из ВКЛЮЧЕНО в ВЫКЛЮЧЕНО. Не включайте эту опцию для служб, которые должны завершить свои транзакции. Применимо, если используется персистенция сайта на основе прокси-сервера соединения.
hashid строка			Уникальный идентификатор хэша для службы GSLB, используемый методами балансировки нагрузки на основе хэша. Минимальное значение = `1`
healthmonitor логический		Варианты: no yes	Мониторинг работоспособности службы 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
	monitor_name строка		Имя монитора.
	weight строка		Вес, присваиваемый привязке монитор-служба. Большее число указывает больший вес. Вносит вклад в порог мониторинга, определяющий состояние службы. Минимальное значение = `1` Максимальное значение = `100`
monthreshold строка			Пороговое значение мониторинга для службы GSLB. Если сумма весов мониторов, привязанных к этой службе GSLB и находящихся в состоянии ВКЛЮЧЕНО, не равна или не больше этого порогового значения, служба помечается как ВЫКЛЮЧЕНО. Минимальное значение = `0` Максимальное значение = `65535`
nitro_pass строка / обязательно			Пароль для аутентификации на узле netscaler.
nitro_protocol строка		Варианты: http ← https	Какой протокол использовать при доступе к объектам 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 в API NITRO
publicip строка			Общедоступный IP-адрес, который устройство NAT переводит в частный IP-адрес службы GSLB. Необязательно.
publicport строка			Общедоступный порт, связанный с общедоступным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно.
save_config логический		Варианты: no yes ←	Если `yes`, модуль сохранит конфигурацию на узле netscaler, если внесёт какие-либо изменения. Модуль не сохранит конфигурацию на узле netscaler, если не внесёт никаких изменений.
servername строка			Имя сервера, на котором размещена служба GSLB. Минимальная длина = 1
servicename строка			Имя службы GSLB. Должно начинаться с ASCII буквенно-цифрового символа или символа подчеркивания `_`, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания `_`, хэша `#`, точки `.`, пробелы, двоеточия `:`, знака @ `@`, знака = `=`, и дефиса `-` символы. Может быть изменено после создания службы GSLB. Минимальная длина = 1
servicetype строка		Варианты: HTTP FTP TCP UDP SSL SSL_BRIDGE SSL_TCP NNTP ANY SIP_UDP SIP_TCP SIP_SSL RADIUS RDP RTSP MYSQL MSSQL ORACLE	Тип создаваемой службы.
sitename строка			Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1
sitepersistence строка		Варианты: ConnectionProxy HTTPRedirect NONE	Использовать персистенцию сайта на основе файлов cookie. Применимо только к `HTTP` и `SSL` службам GSLB.
siteprefix строка			Префикс сайта. Когда служба привязана к виртуальному серверу GSLB, домен сайта GSLB генерируется внутри для каждой пары служба-домен, объединяя префикс сайта службы и имя домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации персистенции сайта на основе HTTP-перенаправления устройство NetScaler перенаправляет запросы GSLB в службы GSLB, используя их домены сайта.
state строка		Варианты: absent present ←	Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler.
validate_certs логический		Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами сети Citrix NetScaler см. на https://www.ansible.com/ansible-netscaler.

Примеры

- name: Setup gslb service 2

  delegate_to: localhost
  register: result
  check_mode: "{{ check_mode }}"

  community.network.netscaler_gslb_service:
    operation: present

    servicename: gslb-service-2
    cnameentry: example.com
    sitename: gslb-site-1

Возвращаемые значения

Общие возвращаемые значения документированы здесь, ниже представлены поля, уникальные для данного модуля:

Ключ	Возвращаемое значение	Описание
diff словарь	ошибка	Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. наше: (str) server1 другое: (str) server2' }
loglines список / элементы=строка	всегда	список зарегистрированных сообщений модуля Пример: ['сообщение 1', 'сообщение 2']
msg строка	ошибка	Сообщение, описывающее причину ошибки Пример: Действие не существует

Авторы

George Nikolopoulos (@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_gslb_service_module.html