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 |
| Мониторинг работоспособности службы 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 |
| Если значение 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 | По умолчанию: yes | Если 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 }}"
netscaler_gslb_service:
operation: present
servicename: gslb-service-2
cnameentry: example.com
sitename: gslb-site-1
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| diff словарь | ошибка | Список различий между фактически настроенным объектом и конфигурацией, заданной в модуле Пример: { 'targetlbvserver': 'различие. наше: (строка) сервер1 другое: (строка) сервер2' } |
| 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.5/modules/netscaler_gslb_service_module.html
