netscaler_gslb_site — Управление сущностями сайта gslb в Netscaler.
Новая версия 2.4.0.
Обзор
- Управление сущностями сайта gslb в Netscaler.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| clip | IP-адрес кластера. Укажите этот параметр для подключения к удалённому сайту кластера для автоматической синхронизации GSLB. Примечание: IP-адрес кластера определяется при создании кластера. | |
| metricexchange |
| Обмен метриками с другими сайтами. Метрики обмениваются с использованием протокола Metric Exchange Protocol (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 bool |
| Если 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 включён, но состояние службы, полученное через обмен метриками, — ВЫКЛЮЧЕНО. |
| validate_certs | По умолчанию: "yes" | Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверенные сертификаты. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. на странице 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': 'различие. наше: (строка) server1 другое: (строка) server2' } |
| loglines список | всегда | Список сообщений журнала, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, описывающее причину ошибки Пример: Действие не существует |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Обслуживание
Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. См. поддержку и обслуживание модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Георгий Николопулос (@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.6/modules/netscaler_gslb_site_module.html
