Модуль community.network.netscaler_gslb_service – Управление сущностями gslb-службы в Netscaler.
Примечание
Этот модуль является частью коллекции community.network (версия 5.0.3).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.network. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.
Чтобы использовать его в плейбуке, укажите: community.network.netscaler_gslb_service.
Описание
- Управление сущностями gslb-службы в Netscaler.
Псевдонимы: network.netscaler.netscaler_gslb_service
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- 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, используемый методами балансировки нагрузки на основе хэша. Минимальное значение = |
healthmonitor логическое | Мониторинг состояния службы GSLB. Варианты:
|
ipaddress строка | IP-адрес службы GSLB. Должен представлять сервер балансировки нагрузки, переключения содержимого или VPN на приборе NetScaler или IP-адрес другого устройства балансировки нагрузки. |
maxaaausers строка | Максимальное количество одновременных подключенных пользователей SSL VPN к виртуальному VPN-серверу, представленному этой службой GSLB. Служба GSLB, количество пользователей которой достигает максимума, не учитывается при принятии решения GSLB, пока количество не опустится ниже максимума. Минимальное значение = Максимальное значение = |
maxbandwidth строка | Целое число, определяющее максимальную пропускную способность, разрешенную для службы. Служба GSLB, пропускная способность которой достигает максимума, не учитывается при принятии решения GSLB, пока ее потребление пропускной способности не опустится ниже максимума. |
maxclient строка | Максимальное количество открытых соединений, которые может поддерживать служба в любой момент времени. Служба GSLB, количество соединений которой достигает максимума, не учитывается при принятии решения GSLB, пока количество соединений не опустится ниже максимума. Минимальное значение = Максимальное значение = |
monitor_bindings строка | Привязать мониторы к этой службе gslb |
|
monitor_name строка |
Имя монитора. |
|
weight строка |
Вес, назначаемый привязке монитора к службе. Большее число указывает больший вес. Вносит вклад в пороговое значение мониторинга, которое определяет состояние службы. Минимальное значение = Максимальное значение = |
monthreshold строка | Значение порога мониторинга для службы GSLB. Если сумма весов мониторов, привязанных к этой службе GSLB и находящихся в состоянии ВКЛ, не равна или не больше этого порога, служба помечается как ВЫКЛ. Минимальное значение = Максимальное значение = |
nitro_pass строка / обязательно | Пароль для аутентификации на узле netscaler. |
nitro_protocol строка | Какой протокол использовать при доступе к объектам API nitro. Варианты:
|
nitro_timeout float | Время в секундах до возникновения ошибки тайм-аута при установлении нового сеанса с Netscaler Default: |
nitro_user string / required | Имя пользователя для аутентификации на узле netscaler. |
nsip string / required | IP-адрес устройства Netscaler, к которому будут выполняться вызовы API Nitro. Порт может быть указан с помощью двоеточия (:). Например, 192.168.1.1:555. |
port string | Порт, на котором работает балансирующий узел, представленный данной службой GSLB. Минимальное значение = 1 Диапазон 1 - 65535 * в CLI представлен как 65535 в NITRO API |
publicip string | Публичный IP-адрес, на который устройство NAT перенаправляет частный IP-адрес службы GSLB. Необязательно. |
publicport string | Публичный порт, связанный с публичным IP-адресом службы GSLB. Порт сопоставляется с частным номером порта службы. Применимо к локальной службе GSLB. Необязательно. |
save_config boolean | Если Модуль не будет сохранять конфигурацию на узле netscaler, если он не внес никаких изменений. Choices:
|
servername string | Имя сервера, на котором размещена служба GSLB. Минимальная длина = 1 |
servicename string | Имя для службы GSLB. Должно начинаться с буквенно-цифрового символа ASCII или символа подчеркивания Минимальная длина = 1 |
servicetype string | Тип службы для создания. Choices:
|
sitename string | Имя сайта GSLB, к которому принадлежит служба. Минимальная длина = 1 |
sitepersistence string | Использовать сохранение состояния сессии на основе cookie. Применимо только к службам GSLB типа Choices:
|
siteprefix string | Префикс сайта. Когда служба привязана к виртуальному серверу GSLB, домен сайта GSLB генерируется внутренне для каждой пары служба-домен путем конкатенации префикса сайта службы и имени домена. Если указана специальная строка NONE, строка префикса сайта сбрасывается. При реализации сохранения состояния сессии HTTP-перенаправления устройство NetScaler перенаправляет запросы GSLB на службы GSLB, используя их домены сайта. |
state string | Состояние ресурса, настраиваемого модулем на узле netscaler. При наличии ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При отсутствии ресурс будет удален с узла netscaler. Choices:
|
validate_certs boolean | Если Choices:
|
Примечания
Примечание
- Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами Citrix NetScaler см. 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 словарь | Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле Возвращается: при ошибке Пример: |
loglines список / элементы=строка | Список сообщений, записанных модулем Возвращается: всегда Пример: |
msg строка | Сообщение, описывающее причину ошибки Возвращается: при ошибке Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/netscaler_gslb_service_module.html