Spec-Zone.ru › Ansible

Модуль community.network.netscaler_gslb_site — Управление сущностями сайта gslb в Netscaler.

Примечание

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

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

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

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

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

Описание

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

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

Требования

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

  • nitro python sdk

Параметры

Параметр

Комментарии

clip

строка

IP-адрес кластера. Укажите этот параметр для подключения к удалённому сайту кластера для автоматической синхронизации GSLB. Примечание: IP-адрес кластера определяется при создании кластера.

metricexchange

строка

Обмен метриками с другими сайтами. Метрики обмениваются с использованием протокола обмена метриками (MEP). Приложения в настройке GSLB обмениваются информацией о состоянии каждые пять секунд.

Если вы отключите обмен метриками, вы можете использовать только статические методы балансировки нагрузки (например, круговую очередь, статическую близость или методы на основе хеша), и если вы отключите обмен метриками, когда динамический метод балансировки нагрузки (например, наименьшее подключение) работает, устройство вернётся к круговой очереди. Кроме того, если вы отключите обмен метриками, вам необходимо использовать монитор для определения состояния GSLB-сервисов. В противном случае служба отмечается как ОТКЛЮЧЕНА.

Варианты:

  • "enabled"
  • "disabled"

naptrreplacementsuffix

строка

Здесь настроенный суффикс замены naptr будет использоваться для построения поля замены naptr в записи NAPTR.

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

nitro_pass

строка / обязательно

Пароль для аутентификации на узле netscaler.

nitro_protocol

строка

Протокол для доступа к объектам API nitro.

Варианты:

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

nitro_timeout

вещественное число

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

По умолчанию: 310.0

nitro_user

строка / обязательно

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

nsip

строка / обязательно

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

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

nwmetricexchange

строка

Обмен с другими сайтами GSLB сетевыми метриками, такими как время туда и обратно (RTT), полученными из общения с различными локальными серверами DNS (LDNS), используемыми клиентами. Информация о RTT используется в динамическом методе балансировки нагрузки RTT и обменивается каждые 5 секунд.

Варианты:

  • "enabled"
  • "disabled"

parentsite

строка

Родительский сайт GSLB-сайта в топологии «родитель-потомок».

publicclip

строка

IP-адрес, используемый для глобального доступа к удалённому кластеру, когда он развернут за NAT. Он может быть таким же, как и обычный IP-адрес кластера.

publicip

строка

Общедоступный IP-адрес для локального сайта. Требуется только в том случае, если устройство развернуто в частном адресном пространстве, и сайт имеет общедоступный IP-адрес, размещённый на внешнем брандмауэре или устройстве NAT.

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

save_config

булево

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

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

Варианты:

  • false
  • true ← (по умолчанию)

sessionexchange

строка

Обмен постоянными записями сеанса с другими GSLB-сайтами каждые пять секунд.

Варианты:

  • "enabled"
  • "disabled"

siteipaddress

строка

IP-адрес GSLB-сайта. GSLB-сайт использует этот IP-адрес для связи с другими GSLB-сайтами. Для локального сайта используйте любой IP-адрес, принадлежащий устройству (например, SNIP или MIP-адрес или IP-адрес службы ADNS).

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

sitename

строка

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

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

sitetype

строка

Тип создаваемого сайта. Если тип не указан, устройство автоматически определяет и устанавливает тип на основе IP-адреса, назначенного сайту. Если указанный IP-адрес сайта принадлежит устройству (например, MIP-адрес или SNIP-адрес), сайт является локальным. В противном случае это удалённый сайт.

Варианты:

  • "REMOTE"
  • "LOCAL"
END_OF_DOCUMENT_MARKER

state

string

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

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

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

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

triggermonitor

string

Укажите условия, при которых служба GSLB должна контролироваться монитором, если он привязан. Доступные настройки работают следующим образом:

* ALWAYS - Мониторить службу GSLB постоянно.

* MEPDOWN - Мониторить службу GSLB только тогда, когда обмен метриками через протокол обмена метриками (MEP) отключен.

MEPDOWN_SVCDOWN - Мониторить службу в любой из следующих ситуаций:

* Обмен метриками через MEP отключен.

* Обмен метриками через MEP включен, но состояние службы, полученное через обмен метриками, — ВНЕ СТРОЯ.

Варианты:

  • "ALWAYS"
  • "MEPDOWN"
  • "MEPDOWN_SVCDOWN"

validate_certs

boolean

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

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Setup gslb site
  delegate_to: localhost
  community.network.netscaler_gslb_site:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

    sitename: gslb-site-1
    siteipaddress: 192.168.1.1
    sitetype: LOCAL
    publicip: 192.168.1.1
    metricexchange: enabled
    nwmetricexchange: enabled
    sessionexchange: enabled
    triggermonitor: ALWAYS

Значения возврата

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

Ключ

Описание

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_site_module.html

Spec-Zone.ru

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