netscaler_gslb_site – Управление сущностями сайта gslb в Netscaler
Новое в версии 2.4.0.
Краткое описание
- Управление сущностями сайта gslb в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| clip - | IP-адрес кластера. Укажите этот параметр для подключения к удаленному сайту кластера для автоматической синхронизации GSLB. Примечание: IP-адрес кластера определяется при создании кластера. | |
| metricexchange - |
| Обмен метриками с другими сайтами. Метрики обмениваются с помощью протокола обмена метриками (MEP). Приложения в настройке GSLB обмениваются информацией о состоянии каждые пять секунд. Если вы отключите обмен метриками, вы можете использовать только статические методы балансировки нагрузки (например, round robin, статическая близость или методы на основе хеширования), и если вы отключите обмен метриками, когда работает динамический метод балансировки нагрузки (например, наименьшее соединение), устройство переключится на round robin. Также, если вы отключите обмен метриками, вам необходимо использовать монитор для определения состояния служб GSLB. В противном случае служба помечается как НЕДОСТУПНА. |
| naptrreplacementsuffix - | Используемый здесь суффикс замены naptr будет использован для построения поля замены naptr в записи NAPTR. Минимальная длина = 1 | |
| nitro_pass строка / требуется | Пароль для аутентификации на узле netscaler. | |
| nitro_protocol строка |
| Протокол для доступа к объектам API nitro. |
| nitro_timeout число с плавающей точкой | Значение по умолчанию: 310 | Время в секундах до сброса ошибки по тайм-ауту при установлении нового сеанса с Netscaler |
| nitro_user строка / требуется | Имя пользователя для аутентификации на узле netscaler. | |
| nsip строка / требуется | IP-адрес устройства netscaler, где будут выполняться вызовы API nitro. Порт может быть указан с двоеточием (:). Например, 192.168.1.1:555. | |
| nwmetricexchange - |
| Обмен сетевыми метриками (такими как время задержки RTT), полученными от различных локальных серверов DNS (LDNS), используемых клиентами, с другими сайтами GSLB. Информация о RTT используется в динамическом методе балансировки нагрузки RTT и обменивается каждые 5 секунд. |
| parentsite - | Родительский сайт сайта GSLB в топологии «родитель-дочерний». | |
| publicclip - | IP-адрес, используемый для глобального доступа к удаленному кластеру, если он развернут за NAT. Он может быть таким же, как и обычный IP-адрес кластера. | |
| publicip - | Общедоступный IP-адрес локального сайта. Требуется только в том случае, если устройство развернуто в частном адресном пространстве, и сайт имеет общедоступный IP-адрес, размещенный на внешнем брандмауэре или устройстве NAT. Минимальная длина = 1 | |
| save_config логическое значение |
| Если yes, модуль сохранит конфигурацию на узле netscaler, если внесёт какие-либо изменения.Модуль не сохранит конфигурацию на узле netscaler, если не внес никаких изменений. |
| sessionexchange - |
| Обмен постоянными записями сеансов с другими сайтами GSLB каждые пять секунд. |
| siteipaddress - | IP-адрес сайта GSLB. Сайт GSLB использует этот IP-адрес для связи с другими сайтами GSLB. Для локального сайта используйте любой IP-адрес, принадлежащий устройству (например, SNIP или MIP-адрес или IP-адрес службы ADNS). Минимальная длина = 1 | |
| sitename - | Имя сайта GSLB. Должно начинаться с буквенно-цифрового символа ASCII или символа подчеркивания _, и должно содержать только буквенно-цифровые символы ASCII, символы подчеркивания _, решётки #, точки ., пробелы, двоеточия :, знаки @ @, знаки = =, и дефисы -. Не может быть изменено после создания виртуального сервера.Минимальная длина = 1 | |
| sitetype - |
| Тип создаваемого сайта. Если тип не указан, устройство автоматически определяет и устанавливает тип на основе IP-адреса, назначенного сайту. Если указанный IP-адрес сайта принадлежит устройству (например, MIP-адрес или SNIP-адрес), сайт является локальным. В противном случае это удалённый сайт. |
| state строка |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удалён с узла netscaler. |
| triggermonitor - |
| Укажите условия, при которых служба GSLB должна контролироваться монитором, если он привязан. Доступные настройки работают следующим образом: * ALWAYS - Монитор службы GSLB в любое время.* MEPDOWN - Монитор службы GSLB только тогда, когда обмен метриками через протокол обмена метриками (MEP) отключен.MEPDOWN_SVCDOWN - Монитор службы в любой из следующих ситуаций:* Обмен метриками через MEP отключен. * Обмен метриками через MEP включён, но состояние службы, полученное через обмен метриками, — НЕДОСТУПНО. |
| validate_certs логическое значение |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых вами лично, использующих самозаверяющие сертификаты. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Citrix NetScaler см. на странице https://www.ansible.com/ansible-netscaler.
Примеры
- name: Setup gslb site
delegate_to: localhost
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': 'различие. наше: (str) server1 другое: (str) server2' } |
| loglines список | всегда | список зарегистрированных сообщений модуля. Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, подробно описывающее причину ошибки. Пример: Действие не существует |
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- George Nikolopoulos (@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.8/modules/netscaler_gslb_site_module.html
