Spec-Zone.ru › Ansible 2.11

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

Примечание

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

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

Для использования в playbook, укажите: community.network.avi_serviceenginegroup.

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

Обзор

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

Требования

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

  • avisdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
accelerated_networking
логический
    Варианты:
  • нет
  • да
Включить ускоренную сеть для azure се.
Ускоренная сеть включает виртуализацию ввода/вывода с одним корнем (sr-iov) для виртуальной машины се.
Это улучшает производительность сети.
Поле добавлено в 17.2.14, 18.1.5, 18.2.1.
active_standby
логический
    Варианты:
  • нет
  • да
Сервисные движки в режиме актив/резерв для аварийного переключения HA.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
additional_config_memory
строка
Указывает процент конфигурационной памяти, используемой для обновлений конфигурации.
Допустимые значения от 0 до 90.
Поле устарело в 18.1.2.
Поле добавлено в 18.1.1.
advertise_backend_networks
логический
    Варианты:
  • нет
  • да
Опубликовать доступность сетей серверов бэкенда через adc через BGP для функции шлюза по умолчанию.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
aggressive_failure_detection
логический
    Варианты:
  • нет
  • да
Включить агрессивную конфигурацию аварийного переключения для HA.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
algo
строка
При компактном размещении виртуальные сервисы размещаются на существующих се до достижения максимального предела vs_per_se.
Варианты перечисления - PLACEMENT_ALGO_PACKED, PLACEMENT_ALGO_DISTRIBUTED.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как PLACEMENT_ALGO_PACKED.
allow_burst
логический
    Варианты:
  • нет
  • да
Разрешить создание се с использованием лицензии burst.
Поле добавлено в 17.2.5.
api_context
словарь
Контекст API Avi, который включает текущий идентификатор сессии и маркер CSRF.
Это позволяет пользователю выполнить одно входное действие и повторно использовать сессию.
api_version
строка
Значение по умолчанию:
"16.4.4"
Версия API Avi для использования с API Avi и объектами.
app_cache_percent
строка
Процентное значение от общей памяти се, зарезервированной для кэширования приложений.
Это свойство загрузки се, требующее перезагрузки се.
Допустимые значения от 0 до 100.
Специальные значения - 0 - 'отключено'.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
app_learning_memory_percent
строка
Процентное значение от общей памяти се, зарезервированной для обучения приложению.
Это свойство загрузки се, требующее перезагрузки се.
Допустимые значения от 0 до 10.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
archive_shm_limit
строка
Объем памяти се в ГБ, до которого общая память собирается в архив ядра.
Поле добавлено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 8.
async_ssl
логический
    Варианты:
  • нет
  • да
Сеансы SSL будут обрабатываться выделенными потоками SSL.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
async_ssl_threads
строка
Количество потоков async ssl на се_dp.
Допустимые значения от 1 до 16.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
auto_rebalance
логический
    Варианты:
  • нет
  • да
Если установлено, виртуальные сервисы будут автоматически мигрированы, когда нагрузка на се ниже минимального или выше максимального пороговых значений.
Если auto_rebalance не установлен, генерируются только уведомления.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
auto_rebalance_capacity_per_se
строка
Ёмкости се для автоматического перераспределения для каждого критерия.
Поле добавлено в 17.2.4.
auto_rebalance_criteria
строка
Набор критериев для автоматического перераспределения се.
Варианты перечисления - 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
строка
Частота перебалансировки, если включена функция «автоматическое перераспределение».
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 300.
auto_redistribute_active_standby_load
логический
    Варианты:
  • нет
  • да
Перераспределение виртуальных сервисов со взятого се на заменяющее се может привести к кратковременному падению трафика.
Если опция автоматического перераспределения нагрузки оставлена в состоянии по умолчанию (выключено), для любого перераспределения необходимо выполнить вызовы API rest.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
avi_api_patch_op
строка
    Варианты:
  • добавить
  • заменить
  • удалить
Операция исправления для использования при использовании avi_api_update_method как исправление.
avi_api_update_method
строка
    Варианты:
  • put ←
  • patch
Метод по умолчанию для обновления объекта - HTTP PUT.
Установка на patch переопределит это поведение на использование HTTP PATCH.
avi_credentials
словарь
Словарь учетных данных Avi, который можно использовать вместо перечисления данных входа в контроллер Avi.
api_version
строка
Значение по умолчанию:
"16.4.4"
Версия контроллера Avi
controller
строка
IP-адрес или SQDN контроллера Avi
csrftoken
строка
Маркер csrf API контроллера Avi для повторного использования существующей сессии с идентификатором сессии
password
строка
Пароль контроллера Avi
port
строка
Порт контроллера Avi
session_id
строка
Идентификатор сессии API контроллера Avi для повторного использования существующей сессии с csrftoken
tenant
строка
Значение по умолчанию:
"admin"
Тенант контроллера Avi
tenant_uuid
строка
UUID тенанта контроллера Avi
timeout
строка
Значение по умолчанию:
300
Таймаут запроса контроллера Avi
token
строка
Токен API контроллера Avi
username
строка
Имя пользователя контроллера Avi
avi_disable_session_cache_as_fact
логический
    Варианты:
  • нет ←
  • да
Отключает кэширование информации о сессии avi в качестве факта.
bgp_state_update_interval
строка
Интервал обновления состояния BGP peer.
Допустимые значения от 5 до 100.
Поле добавлено в 17.2.14, 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
buffer_se
строка
Избыточная емкость сервисного движка, выделенная для аварийного переключения HA.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
cloud_ref
строка
Ссылка на объект типа cloud.
config_debugs_on_all_cores
логический
    Варианты:
  • нет
  • да
Включить конфигурационные отладки на всех ядрах се.
Поле добавлено в 17.2.13, 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
connection_memory_percentage
строка
Процент памяти для состояния соединения.
Это произойдёт за счёт памяти, используемой для кэша http в памяти.
Допустимые значения от 10 до 90.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 50.
END_OF_DOCUMENT_MARKER
контроллер
строка
Значение по умолчанию:
""
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
булево
    Варианты:
  • нет
  • да
Остановить использование функций offload checksum tcp/udp и ip сетевых адаптеров.
Поле введено в 17.1.14, 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_gro
булево
    Варианты:
  • нет
  • да
Отключить generic receive offload (gro) в драйвере dpdk poll-mode в пути приёма пакетов.
Gro включен по умолчанию на сетевых адаптерах, которые не поддерживают lro (large receive offload) или не получают повышения производительности от lro.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disable_se_memory_check
булево
    Варианты:
  • нет
  • да
Если установлено, отключить проверку конфигурации памяти, выполняемую в узле обслуживания.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_tso
булево
    Варианты:
  • нет
  • да
Отключить tcp segmentation offload (tso) в драйвере dpdk poll-mode в пути передачи пакетов.
Tso включен по умолчанию на сетевых адаптерах, которые его поддерживают.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disk_per_se
строка
Объем дискового пространства для каждой из виртуальных машин узла обслуживания.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
distribute_load_active_standby
булево
    Варианты:
  • нет
  • да
Использовать как активный, так и резервный узлы обслуживания для размещения виртуальных сервисов в режиме HA актив/резерв.
Значение по умолчанию, если не указано в 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 с балансировщиком нагрузки базовой версии.
Если установлено, дополнительные балансировщики нагрузки Azure будут автоматически созданы, если ресурсы в существующем балансировщике нагрузки будут исчерпаны.
Поле введено в 17.2.10, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_routing
булево
    Варианты:
  • нет
  • да
Включить маршрутизацию для этой группы узлов обслуживания.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_vip_on_all_interfaces
булево
    Варианты:
  • нет
  • да
Включить vip на всех интерфейсах узла обслуживания.
Поле введено в 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 настроена для режима HA актив/резерв 1+1, плавающие IP-адреса будут рекламироваться только активным узлом обслуживания в паре.
Виртуальные службы в этой группе должны быть отключены/включены для того, чтобы изменения плавающих IP-адресов вступили в силу.
Только активный узел обслуживания, принимающий виртуальные службы, помеченный тегом актив/резерв 1, будет рекламировать этот плавающий IP-адрес, когда включено ручное распределение нагрузки.
floating_intf_ip_se_2
строка
Если группа serviceenginegroup настроена для режима HA актив/резерв 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
    Варианты:
  • нет
  • да
Включить активный мониторинг состояния со стороны резервного se для всех размещенных виртуальных сервисов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
host_attribute_key
string
Ключ пары (ключ, значение), определяющей метку для набора узлов, обычно в облаках контейнеров.
Необходимо указывать вместе с host_attribute_value.
Се могут быть сконфигурированы по-разному, включая режимы высокой доступности в различных группах se.
Может также использоваться для изоляции между различными классами виртуальных сервисов.
Группа se виртуальных сервисов может быть указана с помощью аннотаций/меток.
Пространство имен openshift/kubernetes может быть снабжено аннотацией с соответствующей меткой группы se, такой как openshift.io/node-selector apptype=prod.
Если в облаке используются несколько групп se с указанными атрибутами узла, может существовать только одна группа se как группа match-all без
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 для группы безопасности se для разрешения доступа к данным vip из удаленного типа 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 для группы безопасности se для разрешения доступа 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 для экземпляра se.
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
Максимальный объем диска (в МБ), который будет выделен se.
Используется исключительно для данных отладки и логов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10000.
max_cpu_usage
string
Когда использование ЦП на se превысит этот порог, виртуальные сервисы, размещенные на этом se, могут быть перебалансированы на другие se для уменьшения нагрузки.
В рамках этого процесса может быть создан новый se.
Допустимые значения от 40 до 90.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 80.
max_memory_per_mempool
string
Максимальный объем байт, который может быть выделен в одном mempool.
Поле введено в 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 опустится ниже минимального порога, виртуальные сервисы, размещенные на этом se, могут быть объединены на другие менее загруженные се.
После объединения неиспользуемые движки сервисов могут быть удалены.
Допустимые значения от 20 до 60.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
min_scaleout_per_vs
string
Минимальное количество активных движков сервиса для виртуального сервиса.
Допустимые значения от 1 до 64.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
min_se
string
Минимальное количество движков сервиса в этой группе (актуально только для автоматического перебалансирования се).
Допустимые значения от 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.
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
логический тип
    Варианты:
  • no
  • yes
Режим се-по-приложению предназначен для развертывания выделенных балансировщиков нагрузки по приложениям (vs).
В этом режиме каждый се ограничен максимумом 2 виртуальными сервисами.
Vcpus в се по-приложению учитываются при расчете лицензионного использования со скоростью 25%.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
placement_mode
строка
Если режим размещения — 'авто', виртуальные сервисы автоматически размещаются на узлах сервиса.
Варианты перечисления — PLACEMENT_MODE_AUTO.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как PLACEMENT_MODE_AUTO.
realtime_se_metrics
строка
Включить или отключить метрики се в реальном времени.
reboot_on_stop
логический тип
    Варианты:
  • no
  • yes
Перезагрузить систему, если се остановлен.
Поле введено в 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
строка
Параметры профиля dosthreshold для serviceenginegroup.
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
логический тип
    Варианты:
  • no
  • yes
Включает режим предпросмотра пакета при приеме в режиме pcap.
Введено для решения проблемы с драйвером hv_netvsc.
Режим предпросмотра пытается обеспечить согласованность представлений приложения и ядра о кольцах приема.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_pcap_reinit_frequency
строка
Частота в секундах, с которой периодически выполняется проверка pcap-переинициализации.
Может использоваться совместно с настройкой 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.
Если не установлено, выполняется безусловная переинициализация.
Это значение проверяется каждые pcap_reinit_frequency интервалов.
Поле введено в 17.2.13, 18.1.3, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_probe_port
строка
Порт TCP на se, где будет выполняться эхо-сервис.
Поле введено в 17.2.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 7.
se_remote_punt_udp_port
строка
Порт UDP для пакетов punt в режиме моста Docker.
Поле введено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1501.
se_routing
логический тип
    Варианты:
  • no
  • yes
Включить маршрутизацию через путь передачи данных узла сервиса.
При отключении маршрутизация выполняется ядром Linux.
Для эффективности маршрутизации се требуется включение маршрутизации IP в группе узлов сервиса.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
se_sb_dedicated_core
логический тип
    Варианты:
  • no
  • yes
Побочный трафик будет обрабатываться выделенным ядром.
Поле введено в 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
строка
Множитель для потоков се на основе vcpu.
Допустимые значения: 1-10.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
se_tracert_port_range
строка
Диапазон портов трассировки.
Поле введено в 17.2.8.
se_tunnel_mode
строка
Определяет, активен ли dsr со вторичного се или нет. 0 — определяется автоматически на основе типа гипервизора. 1 — отключает dsr безусловно. 2 — включает dsr безусловно.
Допустимые значения: 0-2.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_tunnel_udp_port
строка
Порт UDP для туннелированных пакетов от вторичного к первичному се в режиме моста docker.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1550.
se_udp_encap_ipc
строка
Определяет, будут ли сообщения се-се ipc инкапсулированы в заголовок udp 0 автоматически определяется на основе типа гипервизора.
1 использовать инкапсуляцию udp безусловно.
Допустимые значения 0-1.
Поле введено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_use_dpdk
строка
Определяет, должна ли использоваться библиотека dpdk или нет 0 автоматически определяется на основе типа гипервизора 1 использовать dpdk, если pcap не включен 2
не использовать dpdk.
Допустимые значения 0-2.
Поле введено в 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_vs_hb_max_pkts_in_batch
строка
Максимальное количество агрегированных пакетов сердечногобиения vs, отправляемых в пакете.
Допустимые значения 1-256.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.
se_vs_hb_max_vs_in_pkt
строка
Максимальное количество виртуальных сервисов, для которых сообщения сердечногобиения агрегируются в одном пакете.
Допустимые значения 1-1024.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 256.
self_se_election
логическое
    Варианты:
  • нет
  • да
Разрешить се выбирать первичный среди себя при отсутствии подключения к контроллеру.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
service_ip6_subnets
строка
Подсети IPv6, назначенные группе се.
Требуется для размещения группы vs.
Поле введено в 18.1.1.
service_ip_subnets
строка
Подсети, назначенные группе се.
Требуется для размещения группы vs.
Поле введено в 17.1.1.
shm_minimum_config_memory
строка
Минимальный необходимый общий объём памяти для применения любой конфигурации.
Допустимые значения 0-100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 4.
significant_log_throttle
строка
Это настройка ограничивает количество значимых журналов, генерируемых в секунду на ядро на этом се.
По умолчанию 100 журналов в секунду.
Установите значение ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
ssl_preprocess_sni_hostname
логическое
    Варианты:
  • нет
  • да
(бета) предварительная обработка ssl client hello для расширения имени хоста sni. Если установлено в значение true, это применит ssl протокол(ы) дочернего sni, если они отличаются
от разрешенного ssl протокола(ов) родительского sni.
Поле введено в 17.2.12, 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
state
строка
    Варианты:
  • отсутствует
  • наличие ←
Состояние, которое должно быть применено к сущности.
tenant
строка
По умолчанию:
"admin"
Имя используемого для всех вызовов API Avi и контекста объекта арендатора.
tenant_ref
строка
Ссылка на объект типа арендатора.
tenant_uuid
строка
По умолчанию:
""
UUID арендатора, используемого для всех вызовов API Avi и контекста объекта.
udf_log_throttle
строка
Эта настройка ограничивает количество журналов udf, генерируемых в секунду на ядро на этом се.
Журналы udf генерируются из-за настроенных фильтров журналов клиентов или правил с включённой записью в журнал.
По умолчанию 100 журналов в секунду.
Установите значение ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
url
строка
URL контроллера Avi для объекта.
use_standard_alb
логическое
    Варианты:
  • нет
  • да
Использовать стандартный балансировщик нагрузки azure.
По умолчанию флаг на уровне облака установлен.
Если не задано, он наследуется/используется из флага use_standard_alb облака.
Поле введено в 18.2.3.
username
строка
По умолчанию:
""
Имя пользователя, используемое для доступа к контроллеру Avi. Значение по умолчанию — переменная среды AVI_USERNAME.
uuid
строка
Уникальный идентификатор объекта.
vcenter_clusters
строка
Настройки vcenterclusters для serviceenginegroup.
vcenter_datastore_mode
строка
Варианты перечисления - vcenter_datastore_any, vcenter_datastore_local, vcenter_datastore_shared.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как VCENTER_DATASTORE_ANY.
vcenter_datastores
строка
Список vcenterdatastore.
vcenter_datastores_include
логическое
    Варианты:
  • нет
  • да
Флаг логического типа для установки vcenter_datastores_include.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
vcenter_folder
строка
Папка для размещения всех виртуальных машин service engine в vcenter.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как AviSeFolder.
vcenter_hosts
строка
Настройки vcenterhosts для serviceenginegroup.
vcpus_per_se
строка
Количество vcpu для каждой из виртуальных машин service engine.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
vip_asg
строка
При установке vip_asg, конфигурация vip будет управляться avi.Пользователь сможет настроить vip_asg или vip индивидуально во время создания.
Поле введено в 17.2.12, 18.1.2.
vs_host_redundancy
логическое
    Варианты:
  • нет
  • да
Обеспечение того, что первичный и вторичный service engine развернуты на разных физических узлах.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
vs_scalein_timeout
строка
Время ожидания для масштабирования se с выделением ресурсов для завершения текущих потоков до того, как будет отмечено, что масштабирование завершено.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scalein_timeout_for_upgrade
строка
Во время обновления se время ожидания для масштабирования se с выделением ресурсов, чтобы освободить текущие потоки перед отметкой завершения масштабирования.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scaleout_timeout
строка
Время ожидания для масштабирования се с добавлением ресурсов до готовности перед отметкой завершения масштабирования.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 600.
vs_se_scaleout_additional_wait_time
строка
Время ожидания для отправки уведомления о готовности масштабирования после того, как виртуальная служба была помечена как включенная.
В некоторых развертываниях может быть дополнительная задержка для приема трафика.
Например, для bgp требуется некоторое время для распространения маршрутов.
Допустимые значения 0-20.
Поле введено в 18.1.5,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
vs_se_scaleout_ready_timeout
строка
Таймаут в секундах для service engine для отправки уведомления о готовности масштабирования виртуальной службы.
Допустимые значения 0-60.
Поле введено в 18.1.5,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 25.
vs_switchover_timeout
строка
Во время обновления се в группе се legacy active/standby, время ожидания для нового первичного се принять потоки перед отметкой переключения завершённым.
Поле введено в 17.2.13,18.1.4,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 300.
vss_placement
строка
Параметры для размещения виртуальных служб только на подмножестве ядер се.
Поле введено в 17.2.5.
vss_placement_enabled
boolean
    Варианты:
  • no
  • yes
Если установлено, виртуальные службы будут размещены только на подмножестве ядер se.
Поле введено в версии 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
waf_learning_interval
string
Частота, с которой se публикует результаты обучения waf.
Допустимые значения: 1-43200.
Поле устарело в версии 18.2.3.
Поле введено в версии 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
waf_learning_memory
string
Объем памяти, резервируемый на se для обучения waf.
Не может превышать 5% памяти se.
Поле устарело в версии 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/avi_serviceenginegroup_module.html

Spec-Zone.ru

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