community.network.netscaler_gslb_service – Управление сущностями службы gslb в Netscaler.
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Чтобы использовать его в плейбуке, укажите: community.network.netscaler_gslb_service.
Описание
- Управление сущностями службы gslb в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| appflowlog строка |
| Включить протоколирование информации о потоках приложений. | |
| cip строка |
| В запросе, пересылаемом службе GSLB, вставить заголовок, хранящий IP-адрес клиента. Вставка заголовка клиентского IP используется при использовании основанной на прокси-соединении персистентности сайта. | |
| cipheader строка | Имя HTTP-заголовка, хранящего IP-адрес клиента. Используется с опцией Клиентский IP. Если вставка заголовка клиентского IP включена на службе и имя для заголовка не указано, устройство NetScaler использует имя, указанное параметром cipHeader в команде set ns param или, в графическом интерфейсе, параметр Заголовок клиентского IP в диалоговом окне Настройка параметров HTTP. Минимальная длина = 1 | ||
| clttimeout строка | Время простоя, в секундах, после которого соединение с клиентом закрывается. Применимо при использовании персистентности сайта на основе прокси-соединений. Минимальное значение = 0 Максимальное значение = 31536000 | ||
| cnameentry строка | Каноническое имя службы GSLB. Используется в GSLB на основе CNAME. Минимальная длина = 1 | ||
| comment строка | Любые комментарии, которые вы хотите связать со службой GSLB. | ||
| downstateflush строка |
| Очистить все активные транзакции, связанные со службой GSLB, когда её состояние переходит из ВКЛ в ВЫКЛ. Не включайте эту опцию для служб, которые должны завершить свои транзакции. Применимо при использовании персистентности сайта на основе прокси-соединений. | |
| hashid строка | Уникальный идентификатор хеша для службы GSLB, используемый методами распределения нагрузки на основе хешей. Минимальное значение = 1
| ||
| healthmonitor логический тип |
| Мониторить состояние службы GSLB. | |
| ipaddress строка | IP-адрес службы GSLB. Должен представлять виртуальный сервер балансировки нагрузки, переключения содержимого или VPN на устройстве NetScaler, или IP-адрес другого устройства балансировки нагрузки. | ||
| maxaaausers строка | Максимальное количество одновременных пользователей SSL VPN, которые могут быть подключены к виртуальному серверу VPN, представленному этой службой GSLB. Служба GSLB, количество пользователей которой достигло максимума, не учитывается при принятии решения GSLB, пока счёт не опустится ниже максимума. Минимальное значение = 0
Максимальное значение = 65535
| ||
| maxbandwidth строка | Целое число, определяющее максимальную пропускную способность, разрешенную для службы. Служба GSLB, пропускная способность которой достигла максимума, не учитывается при принятии решения GSLB, пока её потребление пропускной способности не опустится ниже максимума. | ||
| maxclient строка | Максимальное количество открытых подключений, которые может поддерживать служба в любое время. Служба GSLB, количество подключений которой достигло максимума, не учитывается при принятии решения GSLB, пока количество подключений не опустится ниже максимума. Минимальное значение = 0
Максимальное значение = 4294967294
| ||
| monitor_bindings строка | Связывать мониторы с этой службой gslb | ||
| monitor_name строка | Имя монитора. | ||
| weight строка | Вес, назначаемый для привязки монитора к службе. Большее число означает больший вес. Вносит вклад в пороговое значение мониторинга, которое определяет состояние службы. Минимальное значение = 1
Максимальное значение = 100
| ||
| monthreshold строка | Значение порога мониторинга для службы GSLB. Если сумма весов мониторов, привязанных к этой службе GSLB и находящихся в состоянии ВКЛ, не равна или не больше этого значения порога, служба отмечается как ВЫКЛ. Минимальное значение = 0
Максимальное значение = 65535
| ||
| nitro_pass строка / требуется | Пароль для аутентификации на узле netscaler. | ||
| nitro_protocol строка |
| Какой протокол использовать при доступе к объектам API nitro. | |
| nitro_timeout число с плавающей запятой | Значение по умолчанию: 310 | Время в секундах до возникновения ошибки таймаута при установлении нового сеанса с Netscaler | |
| nitro_user строка / требуется | Имя пользователя для аутентификации на узле netscaler. | ||
| nsip строка / требуется | IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт можно указать с двоеточием (:). Например, 192.168.1.1:555. | ||
| port строка | Порт, на котором служит сущность балансировки нагрузки, представленная этой службой GSLB. Минимальное значение = 1 Диапазон 1 - 65535 * в CLI представлено как 65535 в NITRO API | ||
| publicip строка | Публичный IP-адрес, который устройство NAT переводит в частный IP-адрес службы GSLB. Необязательно. | ||
| publicport строка | Публичный порт, связанный с публичным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно. | ||
| save_config логический тип |
| Если yes модуль сохранит конфигурацию на узле netscaler, если вносит какие-либо изменения.Модуль не сохранит конфигурацию на узле netscaler, если не внес никаких изменений. | |
| servername строка | Имя сервера, на котором размещена служба GSLB. Минимальная длина = 1 | ||
| servicename строка | Имя службы GSLB. Должно начинаться с ASCII буквенно-цифрового символа или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания _, хеша #, точки ., пробела, двоеточия :, знака @ @, знака = =, и дефиса - символы. Может быть изменено после создания службы GSLB.Минимальная длина = 1 | ||
| servicetype строка |
| Тип службы для создания. | |
| sitename строка | Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1 | ||
| sitepersistence строка |
| Использование основанной на куках персистентности сайта. Применимо только к HTTP и SSL служба GSLB. | |
| siteprefix строка | Префикс сайта. Когда служба связана с виртуальным сервером GSLB, домен сайта GSLB генерируется внутри для каждой пары связанных служба-домен путем конкатенации префикса сайта службы и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации персистентности сайта с перенаправлением HTTP устройство NetScaler перенаправляет запросы GSLB на службы GSLB, используя их домены сайта. | ||
| state строка |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler. | |
| validate_certs логический тип |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. на сайте https://www.ansible.com/ansible-netscaler.
Примеры
- name: Setup gslb service 2
delegate_to: localhost
register: result
check_mode: "{{ check_mode }}"
community.network.netscaler_gslb_service:
operation: present
servicename: gslb-service-2
cnameentry: example.com
sitename: gslb-site-1
Значения возврата
Общие значения возвращаемых данных описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff словарь | ошибка | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. наше: (строка) server1 другое: (строка) 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_service_module.html
