Spec-Zone.ru › Ansible 2.7

netscaler_servicegroup – Управление конфигурацией группы служб в Netscaler

Новая в версии 2.4.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Обзор

  • Управление конфигурацией группы служб в Netscaler.
  • Этот модуль предназначен для выполнения как на узле управления Ansible, так и на бастионе (шлюзе) с доступом к фактической инстанции Netscaler.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • nitro python sdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
appflowlog
-
    Варианты:
  • enabled
  • disabled
Включить протоколирование информации AppFlow для указанной группы сервисов.
autoscale
-
    Варианты:
  • DISABLED
  • DNS
  • POLICY
Параметр автоматического масштабирования для группы сервисов.
cacheable
boolean
    Варианты:
  • no
  • yes
Использовать виртуальный сервер прозрачной переадресации кеша для перенаправления запроса на сервер кеша.
Примечание: Не устанавливайте этот параметр, если задан тип кеша.
cachetype
-
    Варианты:
  • TRANSPARENT
  • REVERSE
  • FORWARD
Тип кеша, поддерживаемый сервером кеша.
cip
-
    Варианты:
  • enabled
  • disabled
Вставить заголовок Client IP в запросы, перенаправляемые на сервис.
cipheader
-
Имя HTTP-заголовка, значение которого должно быть установлено в IP-адрес клиента. Используется с параметром Client IP. Если вставка IP-адреса клиента включена, а заголовок IP-адреса клиента не указан, используется значение параметра Client IP Header или значение, заданное командой set ns config, в качестве имени заголовка IP-адреса клиента.
Минимальная длина = 1
cka
boolean
    Варианты:
  • no
  • yes
Включить keep-alive для клиента для группы сервисов.
clttimeout
-
Время в секундах, после которого прервать неактивное соединение с клиентом.
Минимальное значение = 0
Максимальное значение = 31536000
cmp
boolean
    Варианты:
  • no
  • yes
Включить сжатие для указанного сервиса.
comment
-
Любая информация о группе сервисов.
disabled
boolean
    Варианты:
  • no ←
  • yes
При установке в yes состояние группы сервисов будет установлено в DISABLED.
При установке в no состояние группы сервисов будет установлено в ENABLED.
Обратите внимание, что из-за ограничений базового API NITRO изменение состояния disabled не приводит к изменению статуса модуля результата.
downstateflush
-
    Варианты:
  • enabled
  • disabled
Очистить все активные транзакции, связанные со всеми службами в группе служб, чьё состояние переходит от ВКЛЮЧЕНО к ВЫКЛЮЧЕНО. Не включайте этот параметр для приложений, которые должны завершить свои транзакции.
graceful
boolean
    Варианты:
  • no
  • yes
Подождать завершения всех существующих подключений к сервису перед отключением сервиса.
healthmonitor
boolean
    Варианты:
  • no
  • yes
Мониторить состояние этого сервиса. Доступные настройки функционируют следующим образом:
yes - Отправлять зонды для проверки состояния сервиса.
no - Не отправлять зонды для проверки состояния сервиса. С параметром NO приложение всегда отображает сервис как ВКЛЮЧЕН.
httpprofilename
-
Имя HTTP-профиля, содержащего настройки HTTP для группы сервисов.
Минимальная длина = 1
Максимальная длина = 127
maxbandwidth
-
Максимальная пропускная способность в Кбит/с, выделенная для всех сервисов в группе сервисов.
Минимальное значение = 0
Максимальное значение = 4294967287
maxclient
-
Максимальное количество одновременных открытых подключений для группы сервисов.
Минимальное значение = 0
Максимальное значение = 4294967294
maxreq
-
Максимальное количество запросов, которые могут быть отправлены по постоянно открытому подключению к группе сервисов.
Примечание: Запросы подключений, превышающие это значение, отклоняются.
Минимальное значение = 0
Максимальное значение = 65535
memberport
-
Порт участника.
monitorbindings
-
Список имён мониторов, которые должны быть привязаны к этому сервису.
Обратите внимание, что мониторы должны быть уже настроены, возможно, с помощью модуля netscaler_lb_monitor или каким-либо другим способом.
monitorname
-
Имя монитора, привязанного к этой группе сервисов.
weight
-
Вес, присваиваемый привязке между монитором и группой сервисов.
monthreshold
-
Минимальная сумма весов мониторов, привязанных к этому сервису. Используется для определения, следует ли обозначить сервис как ВКЛЮЧЕН или ВЫКЛЮЧЕН.
Минимальное значение = 0
Максимальное значение = 65535
netprofile
-
Сеть-профиль для группы сервисов.
Минимальная длина = 1
Максимальная длина = 127
nitro_pass
- / обязательно
Пароль для аутентификации на узле netscaler.
nitro_protocol
-
    Варианты:
  • http ←
  • https
Протокол, используемый при доступе к объектам API nitro.
nitro_timeout
-
По умолчанию:
310
Время в секундах до возникновения ошибки тайм-аута при установлении нового сеанса с Netscaler
nitro_user
- / обязательно
Имя пользователя для аутентификации на узле netscaler.
nsip
- / обязательно
IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro.
Порт может быть указан с двоеточием (:). Например, 192.168.1.1:555.
pathmonitor
-
Мониторинг пути для кластеризации.
pathmonitorindv
-
Индивидуальные решения по мониторингу пути.
rtspsessionidremap
boolean
    Варианты:
  • no
  • yes
Включить сопоставление идентификаторов сеансов RTSP для группы сервисов.
save_config
boolean
    Варианты:
  • no
  • yes ←
Если true, модуль сохранит конфигурацию на узле netscaler, если будут внесены изменения.
Модуль не сохранит конфигурацию на узле netscaler, если изменений не было.
servicegroupname
-
Имя группы сервисов. Должно начинаться с ASCII-буквы или символа подчеркивания _, и должно содержать только ASCII-буквы, цифры, символы подчеркивания _, решётки #, точки ., пробелы, двоеточия :, знаки «@» @, знаки «=» =, и дефисы -. Может быть изменено после создания имени.
Минимальная длина = 1
servicemembers
-
Список словарей, описывающих каждого участника группы сервисов.
customserverid
-
Идентификатор этой пары IP:Порт.
Используется, когда тип персистентности настроен на Custom Server ID.
hashid
-
Хеш-идентификатор сервиса.
Он должен быть уникальным для каждого сервиса.
Этот параметр используется методами балансировки нагрузки на основе хеширования.
Минимальное значение = 1
ip
-
IP-адрес сервиса. Не должен совпадать с уже существующим сервером, определенным по имени.
port
-
Номер порта сервера.
Диапазон 1 - 65535
* в CLI представлен как 65535 в NITRO API
serverid
-
Идентификатор сервиса.
Используется, когда тип персистентности настроен на Custom Server ID.
servername
-
Имя сервера, к которому нужно привязать группу сервисов.
Сервер должен быть уже настроен как именованный сервер.
Минимальная длина = 1
state
-
    Варианты:
  • enabled
  • disabled
Начальное состояние сервиса после привязки.
weight
-
Вес, назначаемый серверам в группе сервисов.
Определяет емкость серверов по отношению к другим серверам в конфигурации балансировки нагрузки.
Чем выше вес, тем выше процент запросов, отправляемых на сервис.
Минимальное значение = 1
Максимальное значение = 100
servicetype
-
    Варианты:
  • HTTP
  • FTP
  • TCP
  • UDP
  • SSL
  • SSL_BRIDGE
  • SSL_TCP
  • DTLS
  • NNTP
  • RPCSVR
  • DNS
  • ADNS
  • SNMP
  • RTSP
  • DHCPRA
  • ANY
  • SIP_UDP
  • SIP_TCP
  • SIP_SSL
  • DNS_TCP
  • ADNS_TCP
  • MYSQL
  • MSSQL
  • ORACLE
  • RADIUS
  • RADIUSListener
  • RDP
  • DIAMETER
  • SSL_DIAMETER
  • TFTP
  • SMPP
  • PPTP
  • GRE
  • SYSLOGTCP
  • SYSLOGUDP
  • FIX
  • SSL_FIX
Протокол, используемый для обмена данными с сервисом.
sp
boolean
    Варианты:
  • no
  • yes
Включить защиту от пиковых нагрузок для группы сервисов.
state
-
    Варианты:
  • present ←
  • absent
Состояние ресурса, настраиваемого модулем на узле Netscaler.
При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля.
При значении absent ресурс будет удален с узла Netscaler.
svrtimeout
-
Время в секундах, после которого будет прервано неактивное соединение сервера.
Минимальное значение = 0
Максимальное значение = 31536000
tcpb
boolean
    Варианты:
  • no
  • yes
Включить буферизацию TCP для группы сервисов.
tcpprofilename
-
Имя TCP-профиля, содержащего настройки TCP для группы сервисов.
Минимальная длина = 1
Максимальная длина = 127
useproxyport
boolean
    Варианты:
  • no
  • yes
Использовать порт прокси в качестве исходного порта при установлении соединений с сервером. При значении NO используется порт подключения клиента в качестве исходного порта для подключения к серверу.
Примечание: Этот параметр доступен только при установке параметра Use Source IP usip в значение yes
usip
-
Использовать IP-адрес клиента в качестве исходного IP-адреса при установлении соединения с сервером. При значении NO, по умолчанию, используется сопоставленный IP-адрес (MIP) или IP-адрес подсети (SNIP) в качестве исходного IP-адреса для инициации соединений с сервером.
validate_certs
-
По умолчанию:
"yes"
Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых вами, которые используют самозаверяющие сертификаты.

Примечания

Примечание

  • Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler Network см. на странице https://www.ansible.com/ansible-netscaler.

Примеры

# The LB Monitors monitor-1 and monitor-2 must already exist
# Service members defined by C(ip) must not redefine an existing server's ip address.
# Service members defined by C(servername) must already exist.

- name: Setup http service with ip members
  delegate_to: localhost
  netscaler_servicegroup:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

    state: present

    servicegroupname: service-group-1
    servicetype: HTTP
    servicemembers:
      - ip: 10.78.78.78
        port: 80
        weight: 50
      - ip: 10.79.79.79
        port: 80
        weight: 40
      - servername: server-1
        port: 80
        weight: 10

    monitorbindings:
      - monitorname: monitor-1
        weight: 50
      - monitorname: monitor-2
        weight: 50

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
diff
словарь
 failure
Список различий между фактически настроенным объектом и конфигурацией, указанной в модуле.

Пример:
{'clttimeout': 'различие. наше: (float) 10.0 другое: (float) 20.0'}
loglines
список
 всегда
Список сообщений, записанных модулем.

Пример:
['сообщение 1', 'сообщение 2']
msg
строка
 failure
Сообщение, описывающее причину ошибки.

Пример:
Действие не существует


Статус

  • Этот модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • 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_servicegroup_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API