Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

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

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

Описание

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

Псевдонимы: network.netscaler.netscaler_gslb_service

Требования

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

  • nitro python sdk

Параметры

Параметр

Комментарии

appflowlog

строка

Включить логирование информации о потоках appflow.

Варианты:

  • "enabled"
  • "disabled"

cip

строка

В запросе, перенаправляемом службе GSLB, вставить заголовок, который хранит IP-адрес клиента. Вставка заголовка клиентского IP используется в основанной на прокси-соединениях персистентности сайта.

Варианты:

  • "enabled"
  • "disabled"

cipheader

строка

Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с опцией «Клиентский IP». Если вставка заголовка клиентского IP включена в службе и имя заголовка не указано, прибор NetScaler использует имя, указанное параметром cipHeader в команде set ns param или, в графическом интерфейсе, параметр Клиентский IP заголовок в диалоговом окне Настройка параметров HTTP.

Минимальная длина = 1

clttimeout

строка

Время простоя, в секундах, после которого соединение клиента закрывается. Применимо, если используется персистентность сайта на основе прокси-соединений.

Минимальное значение = 0

Максимальное значение = 31536000

cnameentry

строка

Каноническое имя службы GSLB. Используется в GSLB на основе CNAME.

Минимальная длина = 1

comment

строка

Любые комментарии, которые вы можете связать со службой GSLB.

downstateflush

строка

Очистить все активные транзакции, связанные со службой GSLB, когда ее состояние переходит с ВКЛ в ВЫКЛ. Не включайте эту опцию для служб, которые должны завершить свои транзакции. Применимо, если используется персистентность сайта на основе прокси-соединений.

Варианты:

  • "enabled"
  • "disabled"

hashid

строка

Уникальный идентификатор хэша для службы GSLB, используемый методами балансировки нагрузки на основе хэша.

Минимальное значение = 1

healthmonitor

логическое

Мониторинг состояния службы GSLB.

Варианты:

  • false
  • true

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

строка

Какой протокол использовать при доступе к объектам API nitro.

Варианты:

  • "http" ← (по умолчанию)
  • "https"

nitro_timeout

float

Время в секундах до возникновения ошибки тайм-аута при установлении нового сеанса с Netscaler

Default: 310.0

nitro_user

string / required

Имя пользователя для аутентификации на узле netscaler.

nsip

string / required

IP-адрес устройства Netscaler, к которому будут выполняться вызовы API Nitro.

Порт может быть указан с помощью двоеточия (:). Например, 192.168.1.1:555.

port

string

Порт, на котором работает балансирующий узел, представленный данной службой GSLB.

Минимальное значение = 1

Диапазон 1 - 65535

* в CLI представлен как 65535 в NITRO API

publicip

string

Публичный IP-адрес, на который устройство NAT перенаправляет частный IP-адрес службы GSLB. Необязательно.

publicport

string

Публичный порт, связанный с публичным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно.

save_config

boolean

Если yes, модуль сохранит конфигурацию на узле netscaler, если он внес какие-либо изменения.

Модуль не будет сохранять конфигурацию на узле netscaler, если он не внес никаких изменений.

Choices:

  • false
  • true ← (default)

servername

string

Имя сервера, на котором размещена служба GSLB.

Минимальная длина = 1

servicename

string

Имя для службы GSLB. Должно начинаться с буквенно-цифрового символа ASCII или символа подчеркивания _ и содержать только буквенно-цифровые символы ASCII, символ подчеркивания _, знак решетки #, точку ., пробел, двоеточие :, символ «@» @, знак равенства = и дефис -. Может быть изменено после создания службы GSLB.

Минимальная длина = 1

servicetype

string

Тип службы для создания.

Choices:

  • "HTTP"
  • "FTP"
  • "TCP"
  • "UDP"
  • "SSL"
  • "SSL_BRIDGE"
  • "SSL_TCP"
  • "NNTP"
  • "ANY"
  • "SIP_UDP"
  • "SIP_TCP"
  • "SIP_SSL"
  • "RADIUS"
  • "RDP"
  • "RTSP"
  • "MYSQL"
  • "MSSQL"
  • "ORACLE"

sitename

string

Имя сайта GSLB, к которому принадлежит служба.

Минимальная длина = 1

sitepersistence

string

Использовать сохранение состояния сессии на основе cookie. Применимо только к службам GSLB типа HTTP и SSL .

Choices:

  • "ConnectionProxy"
  • "HTTPRedirect"
  • "NONE"

siteprefix

string

Префикс сайта. Когда служба привязана к виртуальному серверу GSLB, домен сайта GSLB генерируется внутренне для каждой пары служба-домен путем конкатенации префикса сайта службы и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации сохранения состояния сессии HTTP-перенаправления устройство NetScaler перенаправляет запросы GSLB на службы GSLB, используя их домены сайта.

state

string

Состояние ресурса, настраиваемого модулем на узле netscaler.

При наличии ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля.

При отсутствии ресурс будет удален с узла netscaler.

Choices:

  • "absent"
  • "present" ← (default)

validate_certs

boolean

Если no, SSL-сертификаты не будут проверяться. Это следует использовать только на лично контролируемых сайтах, использующих самозаверяющие сертификаты.

Choices:

  • false
  • true ← (default)

Примечания

Примечание

  • Для получения дополнительной информации об использовании 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": "difference. ours: (str) server1 other: (str) server2"}

loglines

список / элементы=строка

Список сообщений, записанных модулем

Возвращается: всегда

Пример: ["['message 1'", " 'message 2']"]

msg

строка

Сообщение, описывающее причину ошибки

Возвращается: при ошибке

Пример: "Action does not exist"

Авторы

  • George Nikolopoulos (@giorgos-nikolopoulos)

Ссылки на коллекцию

  • Отслеживание ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/netscaler_gslb_service_module.html

Spec-Zone.ru

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