netscaler_gslb_service – Управление сущностями службы gslb в Netscaler.
Новая версия с 2.4.
Краткое описание
- Управление сущностями службы gslb в Netscaler.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| appflowlog - |
| Включить протоколирование информации о потоках appflow. | |
| 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 boolean |
| Мониторить работоспособность службы 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 * в командной строке представлен как 65535 в NITRO API | ||
| publicip - | Общедоступный IP-адрес, который устройство NAT преобразует в частный IP-адрес службы GSLB. Необязательно. | ||
| publicport - | Общедоступный порт, связанный с общедоступным IP-адресом службы GSLB. Порт сопоставлен с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно. | ||
| save_config boolean |
| Если true, модуль сохранит конфигурацию на узле netscaler, если он внес какие-либо изменения. Модуль не сохранит конфигурацию на узле netscaler, если изменений не было. | |
| servername - | Имя сервера, на котором размещена служба GSLB. Минимальная длина = 1 | ||
| servicename - | Имя службы GSLB. Должно начинаться с ASCII буквенно-цифрового или символа подчеркивания, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания, диез, точку, пробел, двоеточие, символ @, символ = и дефис. Может быть изменено после создания службы GSLB. Минимальная длина = 1 | ||
| servicetype - |
| Тип создаваемой службы. | |
| sitename - | Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1 | ||
| sitepersistence - |
| Использовать сохранение состояния сайта на основе cookie. Применимо только к HTTP и SSL служба GSLB. | |
| siteprefix - | Префикс сайта. Когда служба связана с виртуальным сервером GSLB, домен сайта GSLB генерируется внутри для каждой связанной пары служба-домен путем конкатенации префикса сайта службы и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации сохранения состояния сайта с помощью HTTP-перенаправления прибор NetScaler перенаправляет запросы GSLB на службы GSLB, используя их домены сайта. | ||
| state - |
| Состояние ресурса, настраиваемого модулем на узле netscaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла netscaler. | |
| validate_certs - | Default: "yes" | Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами сети Citrix NetScaler см. на странице https://www.ansible.com/ansible-netscaler.
Примеры
- name: Setup gslb service 2
delegate_to: localhost
register: result
check_mode: "{{ check_mode }}"
netscaler_gslb_service:
operation: present
servicename: gslb-service-2
cnameentry: example.com
sitename: gslb-site-1
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff словарь | ошибка | Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: { 'targetlbvserver': 'различие. наш: (строка) server1 другой: (строка) server2' } |
| loglines список | всегда | список зарегистрированных сообщений модуля Пример: ['сообщение 1', 'сообщение 2'] |
| msg строка | ошибка | Сообщение, подробно описывающее причину ошибки Пример: Действие не существует |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.7/modules/netscaler_gslb_service_module.html
