netscaler_gslb_site — Управление сущностями сайта gslb в Netscaler.
Новое в версии 2.4.0.
Обзор
- Управление сущностями сайта gslb в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| clip | IP-адрес кластера. Укажите этот параметр для подключения к удаленному сайту кластера для автоматической синхронизации GSLB. Примечание: IP-адрес кластера определяется при создании кластера. | |
| metricexchange |
| Обмен метриками с другими сайтами. Метрики обмениваются с помощью протокола Metric Exchange Protocol (MEP). Устройства в настройке GSLB обмениваются информацией о состоянии каждые 1 секунду. Если вы отключите обмен метриками, вы можете использовать только статические методы балансировки нагрузки (например, циклический алгоритм, статическая близость или методы на основе хэширования), а если вы отключите обмен метриками, когда используется динамический метод балансировки нагрузки (например, наименьшее подключение), устройство переключается на циклический алгоритм. Также, если вы отключите обмен метриками, вы должны использовать монитор для определения состояния служб GSLB. В противном случае служба отмечается как DOWN. |
| 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 |
| Если значение true, модуль сохранит конфигурацию на узле 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 только тогда, когда обмен метриками через протокол Metrics Exchange Protocol (MEP) отключён.MEPDOWN_SVCDOWN — Мониторить службу в следующих ситуациях:* Обмен метриками через MEP отключён. * Обмен метриками через MEP включён, но состояние службы, полученное через обмен метриками, DOWN. |
| validate_certs | Значение по умолчанию: yes | Если 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 словарь | failure | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. наше: (строка) server1 другое: (строка) server2' } |
| loglines список | всегда | Список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | failure | Сообщение, описывающее причину ошибки Пример: Действие не существует |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/netscaler_gslb_site_module.html
