community.network.netscaler_gslb_site – Управление сущностями сайта gslb в Netscaler.
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network
Для использования в playbook укажите: community.network.netscaler_gslb_site
Обзор
- Управление сущностями сайта gslb в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| clip строка | IP-адрес кластера. Укажите этот параметр, чтобы подключиться к удаленному сайту кластера для автоматической синхронизации GSLB. Примечание: IP-адрес кластера определяется при создании кластера. | |
| metricexchange строка |
| Обмен метриками с другими сайтами. Метрики обмениваются с использованием протокола обмена метриками (MEP). Устройства в конфигурации GSLB обмениваются информацией о состоянии здоровья каждые секунду. Если вы отключите обмен метриками, вы можете использовать только статические методы балансировки нагрузки (например, циклический обмен, статическая близость или методы на основе хеширования), и если вы отключите обмен метриками, когда в работе находится метод динамической балансировки нагрузки (например, наименьшее количество подключений), устройство переключается на циклический обмен. Кроме того, если вы отключите обмен метриками, вам необходимо использовать монитор для определения состояния служб 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 строка |
| Обмен с другими сайтами GSLB сетевыми метриками, такими как время туда и обратно (RTT), полученное из сообщений с различными локальными серверами DNS (LDNS), используемыми клиентами. Информация о 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
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 список / элементы=строка | всегда | список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | неудача | Сообщение, описывающее причину неудачи Пример: Действие не существует |
Авторы
- 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.10/collections/community/network/netscaler_gslb_site_module.html