community.network.netscaler_gslb_site – Управление сущностями сайта gslb в Netscaler.
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Чтобы использовать его в книге задач, укажите: 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 строка |
| Обмен сетевыми метриками, такими как время прохождения (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 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': 'различие. наше: (строка) server1 другое: (строка) server2' } |
| loglines список / элементы=строка | всегда | список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | неудача | Сообщение, подробно описывающее причину неудачи Пример: Действия не существует |
Авторы
- George Nikolopoulos (@giorgos-nikolopoulos)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/netscaler_gslb_site_module.html
