Spec-Zone.ru › Ansible 2.10

community.network.avi_serviceenginegroup – Модуль для настройки объекта ServiceEngineGroup Avi RESTful

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Чтобы использовать его в книге задач, укажите: community.network.avi_serviceenginegroup.

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

Обзор

  • Этот модуль используется для настройки объекта ServiceEngineGroup.
  • Дополнительные примеры на https://github.com/avinetworks/devops

Требования

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

  • avisdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
accelerated_networking
boolean
    Варианты:
  • no
  • yes
Включить опцию ускоренной сети для azure се.
Ускоренная сеть включает виртуализацию ввода/вывода с одним корнем (sr-iov) для виртуальной машины се.
Это улучшает производительность сети.
Поле добавлено в 17.2.14,18.1.5,18.2.1.
active_standby
boolean
    Варианты:
  • no
  • yes
Сервисные движки в режиме актив/резерв для отказоустойчивости HA.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
additional_config_memory
string
Указывает процент конфигурационной памяти, используемой для обновлений конфигурации.
Допустимые значения от 0 до 90.
Поле устарело в 18.1.2.
Поле добавлено в 18.1.1.
advertise_backend_networks
boolean
    Варианты:
  • no
  • yes
Рекламировать доступность сетей серверов бэкенда через adc через bgp для функции шлюза по умолчанию.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
aggressive_failure_detection
boolean
    Варианты:
  • no
  • yes
Включить агрессивную настройку отказоустойчивости для HA.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
algo
string
В компактном размещении виртуальные службы размещаются на существующих се, пока не будет достигнут предел max_vs_per_se.
Варианты перечисления — PLACEMENT_ALGO_PACKED, PLACEMENT_ALGO_DISTRIBUTED.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как PLACEMENT_ALGO_PACKED.
allow_burst
boolean
    Варианты:
  • no
  • yes
Разрешить создание се с использованием лицензии burst.
Поле добавлено в 17.2.5.
api_context
dictionary
Контекст API Avi, включающий текущий идентификатор сеанса и маркер CSRF.
Это позволяет пользователю выполнить единый вход и повторно использовать сеанс.
api_version
string
Значение по умолчанию:
"16.4.4"
Версия API Avi для использования с API Avi и объектами.
app_cache_percent
string
Процентное значение от общей памяти се, резервируемой для кэширования приложений.
Это свойство загрузки се, требующее перезапуска се.
Допустимые значения от 0 до 100.
Специальные значения от 0 до 'disable'.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 0.
app_learning_memory_percent
string
Процентное значение от общей памяти се, резервируемой для обучения приложениям.
Это свойство загрузки се, требующее перезапуска се.
Допустимые значения от 0 до 10.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 0.
archive_shm_limit
string
Объем памяти се в ГБ, до которого в ядре архива собирается общая память.
Поле добавлено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 8.
async_ssl
boolean
    Варианты:
  • no
  • yes
Сделки SSL будут обрабатываться выделенными потоками SSL.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
async_ssl_threads
string
Количество асинхронных потоков SSL на се_dp.
Допустимые значения от 1 до 16.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 1.
auto_rebalance
boolean
    Варианты:
  • no
  • yes
При установке виртуальные службы будут автоматически мигрированы, когда нагрузка на се ниже минимальных или выше максимальных пороговых значений.
Только оповещения генерируются, когда auto_rebalance не установлен.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
auto_rebalance_capacity_per_se
string
Емкости се для автоматической балансировки по каждому критерию.
Поле добавлено в 17.2.4.
auto_rebalance_criteria
string
Набор критериев для автоматической балансировки се.
Варианты перечисления — SE_AUTO_REBALANCE_CPU, SE_AUTO_REBALANCE_PPS, SE_AUTO_REBALANCE_MBPS, SE_AUTO_REBALANCE_OPEN_CONNS, SE_AUTO_REBALANCE_CPS.
Поле добавлено в 17.2.3.
auto_rebalance_interval
string
Частота балансировки, если включена 'автоматическая балансировка'.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 300.
auto_redistribute_active_standby_load
boolean
    Варианты:
  • no
  • yes
Перераспределение виртуальных служб с се, принявшей управление, на заменяющую се, может привести к кратковременному потере трафика.
Если опция автоматического перераспределения нагрузки оставлена в выключенном состоянии по умолчанию, любое необходимое перебалансирование требует вызовов API REST.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
avi_api_patch_op
string
    Варианты:
  • add
  • replace
  • delete
Операция исправления, которую использовать при использовании avi_api_update_method как patch.
avi_api_update_method
string
    Варианты:
  • put ←
  • patch
Метод по умолчанию для обновления объекта — HTTP PUT.
Установка в patch изменит это поведение на использование HTTP PATCH.
avi_credentials
dictionary
Словарь учетных данных Avi, который можно использовать вместо перечисления данных входа в контроллер Avi.
api_version
string
Значение по умолчанию:
"16.4.4"
Версия контроллера Avi
controller
string
IP-адрес или SQDN контроллера Avi
csrftoken
string
Маркер CSRF API контроллера Avi для повторного использования существующего сеанса с идентификатором сеанса
password
string
Пароль контроллера Avi
port
string
Порт контроллера Avi
session_id
string
Идентификатор сеанса API контроллера Avi для повторного использования существующего сеанса с csrftoken
tenant
string
Значение по умолчанию:
"admin"
Тенент контроллера Avi
tenant_uuid
string
UUID тенента контроллера Avi
timeout
string
Значение по умолчанию:
300
Таймаут запроса контроллера Avi
token
string
Токен API контроллера Avi
username
string
Имя пользователя контроллера Avi
avi_disable_session_cache_as_fact
boolean
    Варианты:
  • no ←
  • yes
Отключает кеширование информации о сеансе avi в качестве факта.
bgp_state_update_interval
string
Интервал обновления состояния bgp-пиров.
Допустимые значения от 5 до 100.
Поле добавлено в 17.2.14,18.1.5,18.2.1.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 10.
buffer_se
string
Избыточная мощность сервисного движка, предоставленная для отказоустойчивости HA.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 1.
cloud_ref
string
Ссылка на объект типа cloud.
config_debugs_on_all_cores
boolean
    Варианты:
  • no
  • yes
Включить отладку конфигурации на всех ядрах се.
Поле добавлено в 17.2.13,18.1.5,18.2.1.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как False.
connection_memory_percentage
string
Процент памяти для состояния соединения.
Это произойдет за счет памяти, используемой для кэша http в оперативной памяти.
Допустимые значения от 10 до 90.
Значение по умолчанию, если не указано в API или модуле, трактуется контроллером Avi как 50.
контроллер
строка
Значение по умолчанию:
""
IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная окружения AVI_CONTROLLER.
cpu_reserve
булево
    Варианты:
  • нет
  • да
Булевый флаг для установки cpu_reserve.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
cpu_socket_affinity
булево
    Варианты:
  • нет
  • да
Назначает все ядра процессора виртуальным машинам движка сервиса на одном сокете процессора.
Применимо только для облака vcenter.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
custom_securitygroups_data
строка
Пользовательские группы безопасности, которые необходимо связать с виртуальными сетевыми адаптерами данных для экземпляров движков сервиса в облаках OpenStack и AWS.
Поле введено в 17.1.3.
custom_securitygroups_mgmt
строка
Пользовательские группы безопасности, которые необходимо связать с виртуальными сетевыми адаптерами управления для экземпляров движков сервиса в облаках OpenStack и AWS.
Поле введено в 17.1.3.
custom_tag
строка
Пользовательский тег будет использоваться для создания тегов для экземпляра движка сервиса в AWS.
Обратите внимание, что это не то же самое, что префикс для имени движка сервиса.
data_network_id
строка
Подсеть, используемая для запуска сетевого адаптера данных для движков сервиса, используется только для облака Azure.
Переопределяет настройку на уровне облака для подсети движка сервиса.
Поле введено в 18.2.3.
datascript_timeout
строка
Количество инструкций до истечения времени ожидания datascript.
Допустимые значения — от 0 до 100000000.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1000000.
dedicated_dispatcher_core
булево
    Варианты:
  • нет
  • да
Присвоить ядро, которое обрабатывает прием/передачу пакетов из сети, только функции диспетчирования.
Не использовать для функций tcp/ip и ssl.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
description
строка
Определение пользователем описания объекта.
disable_avi_securitygroups
булево
    Варианты:
  • нет
  • да
По умолчанию Avi создает и управляет группами безопасности вместе с пользовательскими группами безопасности, предоставленными пользователем.
Установите это значение в true, чтобы запретить Avi создавать и управлять новыми группами безопасности.
Avi будет использовать только пользовательские группы безопасности, предоставленные пользователем.
Этот параметр поддерживается только для типа облака aws.
Поле введено в 17.2.13,18.1.4,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_csum_offloads
булево
    Варианты:
  • нет
  • да
Остановить использование функций отгрузки контрольной суммы tcp/udp и ip сетевых адаптеров.
Поле введено в 17.1.14, 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_gro
булево
    Варианты:
  • нет
  • да
Отключить общую отгрузку приема (gro) в драйвере приема пакетов dpdk в режиме опроса.
Gro включен по умолчанию на сетевых адаптерах, которые не поддерживают lro (большая отгрузка приема) или не получают повышения производительности от lro.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disable_se_memory_check
булево
    Варианты:
  • нет
  • да
При установке отключить проверку конфигурации памяти, выполняемую в движке сервиса.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_tso
булево
    Варианты:
  • нет
  • да
Отключить отгрузку сегментации tcp (tso) в драйвере передачи пакетов dpdk в режиме опроса.
Tso включен по умолчанию на сетевых адаптерах, которые его поддерживают.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disk_per_se
строка
Объем дискового пространства для каждой виртуальной машины движка сервиса.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
distribute_load_active_standby
булево
    Варианты:
  • нет
  • да
Использовать активные и резервные движки сервиса для размещения виртуальных служб в режиме резервирования активной/резервной нагрузки.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
distribute_queues
булево
    Варианты:
  • нет
  • да
Распределяет владение очередью между ядрами, так что несколько ядер выполняют задачи диспетчера.
Поле введено в 17.2.8.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_hsm_priming
булево
    Варианты:
  • нет
  • да
(это бета-функция).
Включить предварительную подготовку ключа hsm.
При включении обработчики ключей в hsm будут синхронизированы с се до обработки клиентских подключений.
Поле введено в 17.2.7, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_multi_lb
булево
    Варианты:
  • нет
  • да
Применимо только для облака azure с lb основного SKU.
Если установлено, дополнительные lb azure будут автоматически созданы, если ресурсы в существующем lb исчерпаны.
Поле введено в 17.2.10, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_routing
булево
    Варианты:
  • нет
  • да
Включить маршрутизацию для этой группы движков сервиса.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_vip_on_all_interfaces
булево
    Варианты:
  • нет
  • да
Включить vip на всех интерфейсах se.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
enable_vmac
булево
    Варианты:
  • нет
  • да
Использовать виртуальный MAC-адрес для интерфейсов, на которых размещены IP-адреса плавающего интерфейса.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
ephemeral_portrange_end
строка
Конечный номер локального порта для временных подключений исходящего трафика.
Поле введено в 17.2.13, 18.1.5, 18.2.1.
ephemeral_portrange_start
строка
Начальный номер локального порта для временных подключений исходящего трафика.
Поле введено в 17.2.13, 18.1.5, 18.2.1.
extra_config_multiplier
строка
Множитель для дополнительной конфигурации для поддержки большой конфигурации виртуальной службы/пула.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0,0.
extra_shared_config_memory
строка
Дополнительная память конфигурации для поддержки большой конфигурации гео-базы данных.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
floating_intf_ip
строка
Если группа serviceenginegroup настроена для режима резервирования активной/резервной нагрузки 1+1, IP-адреса плавающего интерфейса будут объявляться только активным се в паре.
Виртуальные службы в этой группе должны быть отключены/включены для любых изменений в IP-адресах плавающего интерфейса, чтобы они вступили в силу.
Только активный се, размещающий виртуальную службу, помеченный тегом активной/резервной се 1, будет объявлять этот плавающий IP при включенном ручном распределении нагрузки.
floating_intf_ip_se_2
строка
Если группа serviceenginegroup настроена для режима резервирования активной/резервной нагрузки 1+1, IP-адреса плавающего интерфейса будут объявляться только активным се в паре.
Виртуальные службы в этой группе должны быть отключены/включены для любых изменений в IP-адресах плавающего интерфейса, чтобы они вступили в силу.
Только активный се, размещающий виртуальную службу, помеченный тегом активной/резервной се 2, будет объявлять этот плавающий IP при включенном ручном распределении нагрузки.
flow_table_new_syn_max_entries
строка
Максимальное количество записей таблицы потоков, которые еще не завершили трехстороннее рукопожатие TCP.
Поле введено в 17.2.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
free_list_size
строка
Количество записей в списке свободных элементов.
Поле введено в 17.2.10, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1024.
ha_mode
string
Режим высокой доступности для всех виртуальных служб, использующих эту группу движков сервиса.
Варианты перечисления - HA_MODE_SHARED_PAIR, HA_MODE_SHARED, HA_MODE_LEGACY_ACTIVE_STANDBY.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как HA_MODE_SHARED.
hardwaresecuritymodulegroup_ref
string
Ссылка на объект типа hardwaresecuritymodulegroup.
heap_minimum_config_memory
string
Минимальный объем памяти кучи для применения любой конфигурации.
Допустимые значения от 0 до 100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 8.
hm_on_standby
boolean
    Варианты:
  • нет
  • да
Включить активный мониторинг состояния со стороны резервного движка для всех размещенных виртуальных служб.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
host_attribute_key
string
Ключ пары (ключ, значение), определяющий метку для набора узлов, обычно в облаках контейнеров.
Необходимо указывать вместе с host_attribute_value.
Ses могут быть настроены по-разному, включая режимы высокой доступности, в разных группах se.
Также может использоваться для изоляции между различными классами виртуальных служб.
Группа се виртуальных служб может быть указана с помощью аннотаций/меток.
Пространство имен openshift/kubernetes может быть помечено соответствующей меткой группы se, например, openshift.io/node-selector apptype=prod.
Когда в облаке используются несколько групп se с заданными атрибутами узлов, может существовать только одна группа se как группа, сопоставляющая все значения, без
host_attribute_key.
host_attribute_value
string
Значение пары (ключ, значение), определяющей метку для набора узлов, обычно в облаках контейнеров.
Необходимо указывать вместе с host_attribute_key.
host_gateway_monitor
boolean
    Варианты:
  • нет
  • да
Включить мониторинг шлюза узла при развертывании движка сервиса в качестве контейнера Docker.
Отключено по умолчанию.
Поле введено в 17.2.4.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
hypervisor
string
Переопределить гипервизор по умолчанию.
Варианты перечисления - DEFAULT, VMWARE_ESX, KVM, VMWARE_VSAN, XEN.
ignore_rtt_threshold
string
Игнорировать выборки rtt, если они превышают порог.
Поле введено в 17.1.6,17.2.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 5000.
ingress_access_data
string
Настройка правил ingress для группы безопасности се, чтобы разрешить доступ к данным виртуального IP-адреса из удаленного CIDR.
Варианты перечисления - SG_INGRESS_ACCESS_NONE, SG_INGRESS_ACCESS_ALL, SG_INGRESS_ACCESS_VPC.
Поле введено в 17.1.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как SG_INGRESS_ACCESS_ALL.
ingress_access_mgmt
string
Настройка правил ingress для группы безопасности се, чтобы разрешить доступ к управлению SSH/ICMP из удаленного CIDR.
Варианты перечисления - SG_INGRESS_ACCESS_NONE, SG_INGRESS_ACCESS_ALL, SG_INGRESS_ACCESS_VPC.
Поле введено в 17.1.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как SG_INGRESS_ACCESS_ALL.
instance_flavor
string
Имя экземпляра/flavora для экземпляра се.
iptables
string
Правила iptables.
least_load_core_selection
boolean
    Варианты:
  • нет
  • да
Выбор ядра с наименьшей нагрузкой для нового потока.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
license_tier
string
Указывает уровень лицензии, который будет использоваться.
По умолчанию это значение наследуется из облака.
Варианты перечисления - ENTERPRISE_16, ENTERPRISE_18.
Поле введено в 17.2.5.
license_type
string
Если тип лицензии не указан, выбирается политика лицензирования по умолчанию для типа облака.
Варианты перечисления - LIC_BACKEND_SERVERS, LIC_SOCKETS, LIC_CORES, LIC_HOSTS, LIC_SE_BANDWIDTH, LIC_METERED_SE_BANDWIDTH.
Поле введено в 17.2.5.
log_disksz
string
Максимальная емкость диска (в МБ), которая должна быть выделена для се.
Используется исключительно для отладки и данных журналов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10000.
max_cpu_usage
string
Когда использование процессора на се превышает этот порог, виртуальные службы, размещенные на этом се, могут быть перебалансированы на другие се для уменьшения нагрузки.
В рамках этого процесса может быть создан новый се.
Допустимые значения от 40 до 90.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 80.
max_memory_per_mempool
string
Максимальный объем памяти, который может быть выделен в одном пуле памяти.
Поле введено в 18.1.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.
max_public_ips_per_lb
string
Применимо только к платформе Azure.
Максимальное количество общедоступных IP-адресов на azure lb.
Поле введено в 17.2.12, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
max_rules_per_lb
string
Применимо только к платформе Azure.
Максимальное количество правил на azure lb.
Поле введено в 17.2.12, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 150.
max_scaleout_per_vs
string
Максимальное количество активных движков сервиса для виртуальной службы.
Виртуальные службы восток-запад исключены из этого ограничения.
Допустимые значения от 1 до 64.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 4.
max_se
string
Максимальное количество движков сервиса в этой группе.
Допустимые значения от 0 до 1000.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
max_vs_per_se
string
Максимальное количество виртуальных служб, которые могут быть размещены на одном движке сервиса.
Виртуальные службы восток-запад исключены из этого ограничения.
Допустимые значения от 1 до 1000.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
mem_reserve
boolean
    Варианты:
  • нет
  • да
Флаг boolean для установки mem_reserve.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
memory_for_config_update
string
Указывает процент памяти, зарезервированной для обновлений конфигурации.
Допустимые значения от 0 до 100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 15.
memory_per_se
string
Объем памяти для каждой виртуальной машины движка сервиса.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 2048.
mgmt_network_ref
string
Сеть управления для использования движками сервиса avi.
Это ссылка на объект типа network.
mgmt_subnet
string
Подсеть управления для использования движками сервиса avi.
min_cpu_usage
string
Если использование процессора на se опустится ниже минимального порога, виртуальные службы, размещенные на этом се, могут быть объединены на другие малозагруженные се.
После объединения неиспользуемые движки сервиса могут быть удалены.
Допустимые значения от 20 до 60.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
min_scaleout_per_vs
string
Минимальное количество активных движков сервиса для виртуальной службы.
Допустимые значения от 1 до 64.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
min_se
string
Минимальное количество движков сервиса в этой группе (актуально только для автоматического перебалансирования se).
Допустимые значения от 0 до 1000.
Поле введено в 17.2.13,18.1.3,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
minimum_connection_memory
string
Указывает процент памяти, зарезервированной для подключений.
Допустимые значения от 0 до 100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 20.
minimum_required_config_memory
string
Требуемый доступный объем памяти конфигурации для применения любой конфигурации.
Допустимые значения от 0 до 90.
Поле устарело в 18.1.2.
Поле введено в 18.1.1.
END_OF_DOCUMENT_MARKER
n_log_streaming_threads
строка
Количество потоков для потоковой передачи логов.
Допустимые значения — от 1 до 100.
Поле добавлено в 17.2.12, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
name
строка / обязательно
Имя объекта.
non_significant_log_throttle
строка
Это значение ограничивает количество незначительных логов, генерируемых в секунду на ядро на данном устройстве.
Значение по умолчанию — 100 логов в секунду.
Установите значение 0 (ноль), чтобы отключить ограничение.
Поле добавлено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
num_dispatcher_cores
строка
Количество диспатчерских ядер (0, 1, 2, 4, 8 или 16).
Если значение равно 0, количество диспатчерских ядер вычисляется автоматически.
Допустимые значения — 0, 1, 2, 4, 8, 16.
Поле добавлено в 17.2.12, 18.1.3, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
num_flow_cores_sum_changes_to_ignore
строка
Количество изменений в сумме ядер потоков, которые игнорируются.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 8.
openstack_availability_zone
строка
Поле устарело в 17.1.1.
openstack_availability_zones
строка
Поле добавлено в 17.1.1.
openstack_mgmt_network_name
строка
Имя управляющей сети Avi.
openstack_mgmt_network_uuid
строка
Уникальный идентификатор (UUID) управляющей сети.
os_reserved_memory
строка
Количество дополнительной памяти, которое необходимо зарезервировать для использования операционной системой на устройстве обслуживания.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
password
строка
По умолчанию:
""
Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная окружения AVI_PASSWORD.
per_app
логическое
    Варианты:
  • нет
  • да
Режим per-app se предназначен для развертывания выделенных балансировщиков нагрузки для каждой приложения.
В этом режиме каждое устройство обслуживания ограничено максимальным значением 2 виртуальных сервиса.
Vcpus в устройствах обслуживания per-app учитываются при подсчете лицензионного использования со ставкой 25%.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
placement_mode
строка
Если режим размещения — 'auto', виртуальные сервисы автоматически размещаются на устройствах обслуживания.
Варианты перечисления — PLACEMENT_MODE_AUTO.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как PLACEMENT_MODE_AUTO.
realtime_se_metrics
строка
Включить или отключить метрики се в реальном времени.
reboot_on_stop
логическое
    Варианты:
  • нет
  • да
Перезагрузить систему, если устройство обслуживания остановлено.
Поле добавлено в 17.2.16, 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_bandwidth_type
строка
Выберите пропускную способность se для лицензии на пропускную способность.
Варианты перечисления — SE_BANDWIDTH_UNLIMITED, SE_BANDWIDTH_25M, SE_BANDWIDTH_200M, SE_BANDWIDTH_1000M, SE_BANDWIDTH_10000M.
Поле добавлено в 17.2.5.
se_deprovision_delay
строка
Продолжительность сохранения неиспользуемых виртуальных машин устройств обслуживания перед их удалением.
Если трафик виртуального сервиса резко увеличится, это устройство обслуживания по-прежнему будет доступно для использования, вместо создания нового устройства обслуживания.
Если это значение установлено в 0, контроллер никогда не будет удалять устройства обслуживания, и администратор должен вручную очистить неиспользуемые устройства обслуживания.
Допустимые значения — от 0 до 525600.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 120.
se_dos_profile
строка
Настройки dosthresholdprofile для группы устройств обслуживания.
se_dpdk_pmd
строка
Определяет, должен ли использоваться драйвер режима опроса dpdk, или нет 0 автоматически определяется на основе типа гипервизора/сетевой карты 1 безусловно использовать dpdk
Драйвер режима опроса 2 не использует драйвер режима опроса dpdk.
Допустимые значения — от 0 до 2.
Поле добавлено в 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_flow_probe_retries
строка
Количество попыток зондирования потоков, если ответы не получены.
Допустимые значения — от 0 до 5.
Поле добавлено в 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 2.
se_flow_probe_timer
строка
Таймаут в миллисекундах для записей зондирования потоков.
Допустимые значения — от 10 до 200.
Поле добавлено в 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
se_ipc_udp_port
строка
Порт UDP для se_dp ipc в режиме моста Docker.
Поле добавлено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1500.
se_name_prefix
строка
Префикс для использования в имени виртуальной машины устройств обслуживания.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как Avi.
se_pcap_lookahead
логическое
    Варианты:
  • нет
  • да
Включает режим lookahead приема пакетов в режиме pcap.
Добавлен для решения проблемы с драйвером hv_netvsc.
Режим lookahead пытается обеспечить согласованность представлений приложения и ядра о кольцах приема.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_pcap_reinit_frequency
строка
Частота в секундах, с которой периодически запускается проверка pcap reinit.
Может использоваться совместно с настройкой pcap_reinit_threshold.
(допустимый диапазон 15 минут — 12 часов, 0 — отключает).
Допустимые значения — от 900 до 43200.
Специальные значения — 0 — 'отключить'.
Поле добавлено в 17.2.13, 18.1.3, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_pcap_reinit_threshold
строка
Порог для ошибок приема входных пакетов в режиме pcap, превышение которого приводит к запуску pcap reinit.
Если не установлено, выполняется безусловное переинициализирование.
Это значение проверяется каждые pcap_reinit_frequency интервала.
Поле добавлено в 17.2.13, 18.1.3, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_probe_port
строка
Порт TCP на устройстве обслуживания, где будет выполняться эхо-сервис.
Поле добавлено в 17.2.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 7.
se_remote_punt_udp_port
строка
Порт UDP для пакетов punt в режиме моста Docker.
Поле добавлено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1501.
se_routing
логическое
    Варианты:
  • нет
  • да
Включить маршрутизацию через канальный интерфейс устройства обслуживания.
При отключении маршрутизация выполняется ядром Linux.
Маршрутизация IP должна быть включена в группе устройств обслуживания для того, чтобы маршрутизация се была эффективной.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
se_sb_dedicated_core
логическое
    Варианты:
  • нет
  • да
Побочный трафик будет обрабатываться выделенным ядром.
Поле добавлено в 16.5.2, 17.1.9, 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_sb_threads
строка
Количество потоков побочного трафика на устройстве обслуживания.
Допустимые значения — от 1 до 128.
Поле добавлено в 16.5.2, 17.1.9, 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
se_thread_multiplier
строка
Множитель для потоков se на основе vcpu.
Допустимые значения — от 1 до 10.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
se_tracert_port_range
строка
Диапазон портов трассировки.
Поле добавлено в 17.2.8.
se_tunnel_mode
строка
Определяет, активен ли dsr с вторичного se или нет 0 автоматически определяется на основе типа гипервизора.
1 отключить dsr безусловно.
2 включить dsr безусловно.
Допустимые значения — от 0 до 2.
Поле добавлено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_tunnel_udp_port
string
Порт UDP для туннелируемых пакетов от вторичного к первичному se в режиме моста docker.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1550.
se_udp_encap_ipc
string
Определяет, будут ли сообщения се-се ipc инкапсулированы в заголовке udp 0 автоматически определяется на основе типа гипервизора.
1 использовать инкапсуляцию udp безусловно.
Допустимые значения от 0 до 1.
Поле введено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_use_dpdk
string
Определяет, следует ли использовать библиотеку dpdk или нет 0 автоматически определяется на основе типа гипервизора 1 использовать dpdk, если pcap не включен 2
не использовать dpdk.
Допустимые значения от 0 до 2.
Поле введено в 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_vs_hb_max_pkts_in_batch
string
Максимальное количество агрегированных пакетов хеартибита vs, которые необходимо отправить в пакете.
Допустимые значения от 1 до 256.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.
se_vs_hb_max_vs_in_pkt
string
Максимальное количество виртуальных сервисов, для которых сообщения хеартибита агрегированы в одном пакете.
Допустимые значения от 1 до 1024.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 256.
self_se_election
boolean
    Choices:
  • no
  • yes
Разрешить се выбирать первичный среди себя при отсутствии подключения к контроллеру.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
service_ip6_subnets
string
Подсети IPv6, назначенные группе se.
Необходимо для размещения группы vs.
Поле введено в 18.1.1.
service_ip_subnets
string
Подсети, назначенные группе se.
Необходимо для размещения группы vs.
Поле введено в 17.1.1.
shm_minimum_config_memory
string
Минимальный объем общей памяти, необходимый для применения любой конфигурации.
Допустимые значения от 0 до 100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 4.
significant_log_throttle
string
Это значение ограничивает количество значимых журналов, генерируемых в секунду на ядро на этом se.
Значение по умолчанию — 100 журналов в секунду.
Установите его в ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
ssl_preprocess_sni_hostname
boolean
    Choices:
  • no
  • yes
(beta) Предварительная обработка ssl client hello для расширения имени хоста sni.Если установлено в true, это применит ssl протокол(ы) дочернего sni, если они отличаются
от разрешенных ssl протоколов родительского sni.
Поле введено в 17.2.12, 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
state
string
    Choices:
  • absent
  • present ←
Состояние, которое должно быть применено к сущности.
tenant
string
Default:
"admin"
Имя пользователя, используемого для всех вызовов API Avi и контекста объекта.
tenant_ref
string
Ссылка на объект типа tenant.
tenant_uuid
string
Default:
""
UUID пользователя, используемого для всех вызовов API Avi и контекста объекта.
udf_log_throttle
string
Это значение ограничивает количество журналов udf, генерируемых в секунду на ядро на этом se.
Журналы udf генерируются из-за настроенных фильтров журналов клиентов или правил с включенным ведением журналов.
Значение по умолчанию — 100 журналов в секунду.
Установите его в ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
url
string
URL контроллера Avi для объекта.
use_standard_alb
boolean
    Choices:
  • no
  • yes
Использовать стандартный балансировщик нагрузки azure.
По умолчанию флаг на уровне облака установлен.
Если не установлено, он наследует/использует флаг use_standard_alb из облака.
Поле введено в 18.2.3.
username
string
Default:
""
Имя пользователя, используемое для доступа к контроллеру Avi. Значение по умолчанию — переменная окружения AVI_USERNAME.
uuid
string
Уникальный идентификатор объекта.
vcenter_clusters
string
Настройки vcenterclusters для serviceenginegroup.
vcenter_datastore_mode
string
Варианты перечислений - vcenter_datastore_any, vcenter_datastore_local, vcenter_datastore_shared.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как VCENTER_DATASTORE_ANY.
vcenter_datastores
string
Список vcenterdatastore.
vcenter_datastores_include
boolean
    Choices:
  • no
  • yes
Флаг boolean для установки vcenter_datastores_include.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
vcenter_folder
string
Папка для размещения всех виртуальных машин service engine в vcenter.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как AviSeFolder.
vcenter_hosts
string
Настройки vcenterhosts для serviceenginegroup.
vcpus_per_se
string
Количество vcpu для каждой виртуальной машины service engine.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
vip_asg
string
Если vip_asg задано, конфигурация vip будет управляться avi.Пользователь сможет настроить vip_asg или vip индивидуально во время создания.
Поле введено в 17.2.12, 18.1.2.
vs_host_redundancy
boolean
    Choices:
  • no
  • yes
Обеспечить, чтобы первичные и вторичные service engine развертывались на разных физических хостах.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
vs_scalein_timeout
string
Время ожидания для масштабирования се, чтобы он завершил обработку существующих потоков перед отменой масштабирования.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scalein_timeout_for_upgrade
string
Во время обновления se время ожидания для масштабируемого се, чтобы он завершил обработку существующих потоков перед отменой масштабирования.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scaleout_timeout
string
Время ожидания для масштабируемого se, чтобы он стал готовым, прежде чем отметить завершение масштабирования.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 600.
vs_se_scaleout_additional_wait_time
string
Время ожидания для отправки уведомления о готовности scaleout после того, как виртуальный сервис помечен как активный.
В некоторых развертываниях может быть дополнительная задержка для принятия трафика.
Например, для bgp требуется некоторое время для объявления маршрута.
Допустимые значения от 0 до 20.
Поле введено в 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
vs_se_scaleout_ready_timeout
string
Таймаут в секундах для того, чтобы сервис-движок отправил уведомление о готовности scaleout виртуальной службы.
Допустимые значения от 0 до 60.
Поле введено в 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 25.
vs_switchover_timeout
string
Во время обновления se в группе segroup legacy активный/резервный, время ожидания, чтобы новый первичный se принял потоки перед отменой переключения.
Поле введено в 17.2.13, 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 300.
vss_placement
string
Параметры для размещения виртуальных служб только на подмножестве ядер се.
Поле введено в 17.2.5.
END_OF_DOCUMENT_MARKER
vss_placement_enabled
boolean
    Варианты:
  • no
  • yes
Если установлено, виртуальные службы будут размещены только на подмножестве ядер se.
Поле введено в 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
waf_learning_interval
string
Частота публикации се обучения waf.
Допустимые значения от 1 до 43200.
Поле устарело в 18.2.3.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
waf_learning_memory
string
Объем памяти, резервируемый на se для обучения waf.
Не может превышать 5% памяти се.
Поле устарело в 18.2.3.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
waf_mempool
boolean
    Варианты:
  • no
  • yes
Включить пул памяти для waf.
Поле введено в 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
waf_mempool_size
string
Размер пула памяти, используемого для waf.
Поле введено в 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.

Примечания

Примечание

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

Примеры

- name: Example to create ServiceEngineGroup object
  community.network.avi_serviceenginegroup:
    controller: 10.10.25.42
    username: admin
    password: something
    state: present
    name: sample_serviceenginegroup

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

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

Ключ Возвращаемое значение Описание
obj
словарь
успех, изменение
Объект ServiceEngineGroup (api/serviceenginegroup)


Авторы

  • Gaurav Rastogi (@grastogi23) <grastogi@avinetworks.com>

© 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/avi_serviceenginegroup_module.html

Spec-Zone.ru

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