Spec-Zone.ru › Ansible 2.9

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

Новый в версии 2.4.

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

Описание

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

Требования

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

  • avisdk

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
accelerated_networking
boolean
добавлено в 2.9
    Варианты:
  • 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
-
добавлено в 2.9
Указывает процент конфигурационной памяти, используемой для обновлений конфигурации.
Допустимые значения: 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
-
В компактном размещении виртуальные службы размещаются на существующих сервисных движках до тех пор, пока не будет достигнут лимит max_vs_per_se.
Варианты перечисления - PLACEMENT_ALGO_PACKED, PLACEMENT_ALGO_DISTRIBUTED.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как PLACEMENT_ALGO_PACKED.
allow_burst
boolean
добавлено в 2.5
    Варианты:
  • no
  • yes
Разрешить создание сервисных движков с использованием лицензии burst.
Поле введено в 17.2.5.
api_context
dictionary
добавлено в 2.5
Контекст API Avi, который включает текущий идентификатор сеанса и маркер CSRF.
Это позволяет пользователю выполнить одно вход и повторно использовать сеанс.
api_version
string
Значение по умолчанию:
"16.4.4"
Версия API Avi для использования с API Avi и объектами.
app_cache_percent
-
добавлено в 2.9
Процентное значение всей памяти сервисного движка, резервируемой для кэширования приложений.
Это свойство загрузки сервисного движка, и требуется перезагрузка сервисного движка.
Допустимые значения: 0 - 100.
Специальные значения: 0- 'отключить'.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
app_learning_memory_percent
-
добавлено в 2.9
Процентное значение всей памяти сервисного движка, резервируемой для обучения приложению.
Это свойство загрузки сервисного движка, и требуется перезагрузка сервисного движка.
Допустимые значения: 0 - 10.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
archive_shm_limit
-
Объем памяти сервисного движка в ГБ, до которого собирается общая память в системном архиве.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 8.
async_ssl
boolean
добавлено в 2.4
    Варианты:
  • no
  • yes
SSL-соединения будут обрабатываться выделенными потоками SSL.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
async_ssl_threads
-
добавлено в 2.4
Количество потоков асинхронного SSL на каждый сервисный движок.
Допустимые значения: 1-16.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
auto_rebalance
boolean
    Варианты:
  • no
  • yes
Если установлено, виртуальные сервисы будут автоматически мигрированы, когда нагрузка на сервисный движок меньше минимального или больше максимального порогов.
Если auto_rebalance не установлен, генерируются только оповещения.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
auto_rebalance_capacity_per_se
-
добавлено в 2.5
Емкость сервисного движка для автоматической перебалансировки для каждого критерия.
Поле введено в 17.2.4.
auto_rebalance_criteria
-
добавлено в 2.5
Набор критериев для автоматической перебалансировки сервисного движка.
Варианты перечисления - 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
boolean
    Варианты:
  • no
  • yes
Перераспределение виртуальных служб с захваченного сервисного движка на заменяющий сервисный движок может привести к кратковременной потере трафика.
Если опция автоматического перераспределения нагрузки оставлена в выключенном состоянии по умолчанию, любая требуемая перебалансировка требует вызовов API rest.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
avi_api_patch_op
-
добавлено в 2.5
    Варианты:
  • add
  • replace
  • delete
Операция исправления для использования при использовании avi_api_update_method как исправления.
avi_api_update_method
-
добавлено в 2.5
    Варианты:
  • put ←
  • patch
Метод по умолчанию для обновления объекта — HTTP PUT.
Установка в patch переопределит это поведение для использования HTTP PATCH.
avi_credentials
dictionary
добавлено в 2.5
Словарь учетных данных Avi, который можно использовать вместо перечисления данных входа в контроллер Avi.
api_version
-
Значение по умолчанию:
"16.4.4"
Версия контроллера Avi
controller
-
IP-адрес или SQDN контроллера Avi
csrftoken
-
CSRF-токен API контроллера Avi для повторного использования существующего сеанса с идентификатором сеанса
password
-
Пароль контроллера Avi
port
-
Порт контроллера Avi
session_id
-
Идентификатор сеанса API контроллера Avi для повторного использования существующего сеанса с CSRF-токен
tenant
-
Значение по умолчанию:
"admin"
Тенд контроллера Avi
tenant_uuid
-
Айди контроллера Avi
timeout
-
По умолчанию:
300
Таймаут запроса контроллера Avi
token
-
Токен API контроллера Avi
username
-
Имя пользователя контроллера Avi
avi_disable_session_cache_as_fact
boolean
добавлен в 2.6
    Варианты:
  • no
  • yes
Отключает кеширование информации сеанса avi в качестве факта.
bgp_state_update_interval
-
добавлен в 2.9
Интервал обновления состояния 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
boolean
добавлен в 2.9
    Варианты:
  • no
  • yes
Включить отладку конфигурации на всех ядрах се.
Поле введено в 17.2.13,18.1.5,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
connection_memory_percentage
-
Процент памяти для состояния соединения.
Это повлияет на память, используемую для кэша http в оперативной памяти.
Допустимые значения: 10-90.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 50.
controller
string
По умолчанию:
""
IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная окружения AVI_CONTROLLER.
cpu_reserve
boolean
    Варианты:
  • no
  • yes
Флаг boolean для установки cpu_reserve.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
cpu_socket_affinity
boolean
    Варианты:
  • no
  • yes
Распределить все ядра ЦП для виртуальных машин сервисных узлов на одном сокете ЦП.
Применимо только для облака 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
-
добавлен в 2.9
Подсеть, используемая для создания виртуальной сети данных для сервисных узлов, используется только для облака azure.
Переопределяет параметр подсети сервисного узла на уровне облака.
Поле введено в 18.2.3.
datascript_timeout
-
добавлен в 2.9
Количество инструкций перед истечением времени ожидания datascript.
Допустимые значения: 0-100000000.
Поле введено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1000000.
dedicated_dispatcher_core
boolean
    Варианты:
  • no
  • yes
Назначение ядра, обрабатывающего прием/передачу пакетов из сети, только функции диспетчеризации.
Не использовать для функций tcp/ip и ssl.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
description
-
Пользовательское описание объекта.
disable_avi_securitygroups
boolean
добавлен в 2.9
    Варианты:
  • no
  • yes
По умолчанию, avi создает и управляет группами безопасности вместе с пользовательскими группами безопасности.
Установите это в true, чтобы запретить avi создавать и управлять новыми группами безопасности.
Avi будет использовать только пользовательские группы безопасности, предоставленные пользователем.
Этот параметр поддерживается только для облака aws.
Поле введено в 17.2.13,18.1.4,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_csum_offloads
boolean
добавлен в 2.5
    Варианты:
  • no
  • yes
Остановить использование функций tcp/udp и ip checksum offload сетевых адаптеров.
Поле введено в 17.1.14, 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_gro
boolean
добавлен в 2.5
    Варианты:
  • no
  • yes
Отключить общие функции приема (gro) в драйвере приема пакетов dpdk в режиме опроса.
Gro включен по умолчанию на сетевых адаптерах, которые не поддерживают lro (большое отключение приема) или не получают повышения производительности от lro.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disable_se_memory_check
boolean
добавлен в 2.9
    Варианты:
  • no
  • yes
Если установлено, отключить проверку памяти конфигурации, выполняемую в сервисных узлах.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
disable_tso
boolean
добавлен в 2.5
    Варианты:
  • no
  • yes
Отключить передачу сегментов tcp (tso) в драйвере приема пакетов dpdk в режиме опроса.
Tso включен по умолчанию на сетевых адаптерах, которые его поддерживают.
Поле введено в 17.2.5, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
disk_per_se
-
Количество дискового пространства для каждой из виртуальных машин сервисных узлов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
distribute_load_active_standby
boolean
    Варианты:
  • no
  • yes
Использовать активные и резервные сервисные узлы для размещения виртуальных служб в режиме резервирования активного/резервного режима HA.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
distribute_queues
boolean
добавлен в 2.9
    Варианты:
  • no
  • yes
Распределяет владение очередью между ядрами, так что несколько ядер выполняют обязанности диспетчера.
Поле введено в 17.2.8.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_hsm_priming
boolean
added in 2.6
    Choices:
  • no
  • yes
(это бета-функция).
Включить первичную инициализацию ключей HSM.
Если включено, обработка клиентских подключений будет синхронизирована с ключами HSM до обработки клиентских подключений.
Поле добавлено в 17.2.7, 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_multi_lb
boolean
added in 2.9
    Choices:
  • no
  • yes
Применимо только для облака Azure с базовым SKU lb.
Если установлено, дополнительные azure lb будут автоматически созданы, если ресурсы в существующем lb исчерпаны.
Поле добавлено в 17.2.10, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_routing
boolean
    Choices:
  • no
  • yes
Включить маршрутизацию для этой группы serviceengine.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
enable_vip_on_all_interfaces
boolean
    Choices:
  • no
  • yes
Включить vip на всех интерфейсах se.
Поле добавлено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
enable_vmac
boolean
    Choices:
  • no
  • yes
Использовать виртуальный MAC-адрес для интерфейсов, на которых размещены плавающие IP-адреса интерфейсов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
ephemeral_portrange_end
-
added in 2.9
Конечный локальный номер порта для исходящих подключений.
Поле добавлено в 17.2.13, 18.1.5, 18.2.1.
ephemeral_portrange_start
-
added in 2.9
Начальный локальный номер порта для исходящих подключений.
Поле добавлено в 17.2.13, 18.1.5, 18.2.1.
extra_config_multiplier
-
Множитель для дополнительной конфигурации для поддержки конфигурации больших vs/pool.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.0.
extra_shared_config_memory
-
Дополнительная конфигурационная память для поддержки конфигурации больших гео-баз данных.
Поле добавлено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
floating_intf_ip
-
Если для serviceenginegroup настроено режим резервирования 1+1, плавающие IP-адреса будут рекламироваться только активным се в паре.
Виртуальные службы в этой группе должны быть отключены/включены для вступления в силу любых изменений плавающих IP-адресов.
Только активный се, разместивший vs и помеченный меткой активного резервного се 1, будет рекламировать этот плавающий IP-адрес, когда включено ручное распределение нагрузки.
floating_intf_ip_se_2
-
Если для serviceenginegroup настроено режим резервирования 1+1, плавающие IP-адреса будут рекламироваться только активным се в паре.
Виртуальные службы в этой группе должны быть отключены/включены для вступления в силу любых изменений плавающих IP-адресов.
Только активный се, разместивший vs и помеченный меткой активного резервного се 2, будет рекламировать этот плавающий IP-адрес, когда включено ручное распределение нагрузки.
flow_table_new_syn_max_entries
-
added in 2.5
Максимальное количество записей таблицы потоков, которые еще не завершили трехстороннее рукопожатие TCP.
Поле добавлено в 17.2.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
free_list_size
-
added in 2.9
Количество записей в свободном списке.
Поле добавлено в 17.2.10, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1024.
ha_mode
-
Режим высокой доступности для всех виртуальных служб, использующих эту группу service engine.
Варианты перечисления - HA_MODE_SHARED_PAIR, HA_MODE_SHARED, HA_MODE_LEGACY_ACTIVE_STANDBY.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как HA_MODE_SHARED.
hardwaresecuritymodulegroup_ref
-
Ссылка на объект типа hardwaresecuritymodulegroup.
heap_minimum_config_memory
-
added in 2.9
Минимальный объем памяти кучи для применения любой конфигурации.
Допустимые значения от 0 до 100.
Поле добавлено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 8.
hm_on_standby
boolean
    Choices:
  • no
  • yes
Включить активный мониторинг состояния с резервного се для всех размещенных виртуальных служб.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
host_attribute_key
-
Ключ пары (ключ, значение), определяющий метку для набора узлов, обычно в облаках контейнеров.
Необходимо указать вместе с host_attribute_value.
Се могут быть сконфигурированы по-разному, включая режимы высокой доступности в различных группах se.
Также может использоваться для изоляции между различными классами виртуальных служб.
Группа se виртуальных служб может быть указана с помощью аннотаций/меток.
Пространство имен openshift/kubernetes может быть помечено соответствующей меткой группы се, например, openshift.io/node-selector apptype=prod.
Когда в облаке используются несколько групп se с указанными атрибутами узла, может существовать только одна группа se, как группа match-all, без
host_attribute_key.
host_attribute_value
-
Значение пары (ключ, значение), определяющей метку для набора узлов, обычно в облаках контейнеров.
Необходимо указать вместе с host_attribute_key.
host_gateway_monitor
boolean
added in 2.5
    Choices:
  • no
  • yes
Включить монитор хост-шлюза, когда сервис-движок развернут как контейнер Docker.
Отключен по умолчанию.
Поле добавлено в 17.2.4.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
hypervisor
-
Переопределить значение по умолчанию для гипервизора.
Варианты перечисления - DEFAULT, VMWARE_ESX, KVM, VMWARE_VSAN, XEN.
ignore_rtt_threshold
-
added in 2.5
Игнорировать значения rtt, если они выше порога.
Поле добавлено в 17.1.6,17.2.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 5000.
ingress_access_data
-
added in 2.5
Настроить правила доступа к группе безопасности 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
-
added in 2.5
Настроить правила доступа к группе безопасности 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
-
Имя экземпляра/типа для экземпляра se.
iptables
-
Правила iptables.
least_load_core_selection
boolean
    Выбои:
  • нет
  • да
Выбрать ядро с наименьшей загрузкой для нового потока.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
license_tier
-
добавлено в 2.5
Указывает уровень лицензии, который будет использоваться.
Это поле по умолчанию наследует значение из облака.
Варианты перечисления - ENTERPRISE_16, ENTERPRISE_18.
Поле введено в 17.2.5.
license_type
-
добавлено в 2.5
Если тип лицензии не указан, выбирается стандартное принудительное применение лицензии для типа облака.
Варианты перечисления - LIC_BACKEND_SERVERS, LIC_SOCKETS, LIC_CORES, LIC_HOSTS, LIC_SE_BANDWIDTH, LIC_METERED_SE_BANDWIDTH.
Поле введено в 17.2.5.
log_disksz
-
Максимальная емкость диска (в мб) для выделения се.
Это используется исключительно для отладки и журнальных данных.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10000.
max_cpu_usage
-
Когда использование ЦП на се превышает этот порог, виртуальные службы, размещенные на этом се, могут быть перераспределены на другие се для уменьшения нагрузки.
В рамках этого процесса может быть создано новое се.
Допустимые значения - 40-90.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 80.
max_memory_per_mempool
-
добавлено в 2.9
Максимальный объем байтов, который может быть выделен в одном пуле памяти.
Поле введено в 18.1.5.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.
max_public_ips_per_lb
-
добавлено в 2.9
Применимо только к платформе Azure.
Максимальное количество публичных IP-адресов на azure lb.
Поле введено в 17.2.12, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
max_rules_per_lb
-
добавлено в 2.9
Применимо только к платформе Azure.
Максимальное количество правил на azure lb.
Поле введено в 17.2.12, 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 150.
max_scaleout_per_vs
-
Максимальное количество активных серверных модулей для виртуальной службы.
Допустимые значения - 1-64.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 4.
max_se
-
Максимальное количество серверных модулей в этой группе.
Допустимые значения - 0-1000.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
max_vs_per_se
-
Максимальное количество виртуальных служб, которые могут быть размещены на одном серверном модуле.
Виртуальные службы восток-запад исключаются из этого ограничения.
Допустимые значения - 1-1000.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
mem_reserve
boolean
    Выбои:
  • нет
  • да
Флаг булевого типа для установки mem_reserve.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
memory_for_config_update
-
добавлено в 2.9
Указывает процент памяти, резервируемой для обновлений конфигурации.
Допустимые значения - 0-100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 15.
memory_per_se
-
Объем памяти для каждой из виртуальных машин серверного модуля.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 2048.
mgmt_network_ref
-
Сеть управления для использования серверных модулей avi.
Это ссылка на объект типа сеть.
mgmt_subnet
-
Подсеть управления для использования серверных модулей avi.
min_cpu_usage
-
Когда использование ЦП на се опускается ниже минимального порога, виртуальные службы, размещенные на се, могут быть объединены на другие менее загруженные се.
После объединения неиспользуемые серверные модули могут быть удалены.
Допустимые значения - 20-60.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
min_scaleout_per_vs
-
Минимальное количество активных серверных модулей для виртуальной службы.
Допустимые значения - 1-64.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
min_se
-
добавлено в 2.9
Минимальное количество серверных модулей в этой группе (актуально только для автоматического перераспределения се).
Допустимые значения - 0-1000.
Поле введено в 17.2.13,18.1.3,18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1.
minimum_connection_memory
-
добавлено в 2.9
Указывает процент памяти, резервируемой для соединений.
Допустимые значения - 0-100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 20.
minimum_required_config_memory
-
добавлено в 2.9
Требуемый доступный объем конфигурационной памяти для применения любой конфигурации.
Допустимые значения - 0-90.
Поле устарело в 18.1.2.
Поле введено в 18.1.1.
n_log_streaming_threads
-
добавлено в 2.9
Количество потоков для использования при потоковой передаче журналов.
Допустимые значения - 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
-
добавлено в 2.9
Количество ядра диспечера (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
string
Значение по умолчанию:
""
Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная окружения AVI_PASSWORD.
per_app
boolean
    Варианты:
  • no
  • yes
Режим per-app предназначен для развертывания выделенных балансировщиков нагрузки для каждой приложения (vs).
В этом режиме каждый сервер сервисов ограничен максимальными 2 vss.
Vcpu в per-app ses учитываются при подсчёте лицензионных использований со скоростью 25%.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
placement_mode
-
Если режим размещения «auto», виртуальные сервисы автоматически размещаются на серверах сервисов.
Варианты перечисления — PLACEMENT_MODE_AUTO.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как PLACEMENT_MODE_AUTO.
realtime_se_metrics
-
Включить или отключить метрики се в реальном времени.
reboot_on_stop
boolean
добавлено в 2.9
    Варианты:
  • no
  • yes
Перезагрузить систему, если се остановлен.
Поле добавлено в 17.2.16, 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_bandwidth_type
-
добавлено в 2.5
Выберите пропускную способность се для лицензии на пропускную способность.
Варианты перечисления — 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 для serviceenginegroup.
se_dpdk_pmd
-
добавлено в 2.9
Определяет, должен ли использоваться драйвер режима опроса dpdk, или нет 0 автоматически определяется в зависимости от типа гипервизора/сетевой карты 1 безусловно использовать dpdk
драйвер режима опроса 2 не использовать драйвер режима опроса dpdk.
Допустимые значения: 0-2.
Поле добавлено в 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_flow_probe_retries
-
добавлено в 2.9
Количество попыток зондирования потока, если ответы не получены.
Допустимые значения: 0-5.
Поле добавлено в 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 2.
se_flow_probe_timer
-
добавлено в 2.9
Таймаут в миллисекундах для записей зондирования потока.
Допустимые значения: 10-200.
Поле добавлено в 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
se_ipc_udp_port
-
добавлено в 2.4
Порт UDP для се_dp ipc в режиме моста Docker.
Поле добавлено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1500.
se_name_prefix
-
Префикс, используемый для имени виртуальной машины серверов сервисов.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как Avi.
se_pcap_lookahead
boolean
добавлено в 2.9
    Варианты:
  • no
  • yes
Включает режим lookahead для приёма пакетов в режиме pcap.
Добавлена для устранения проблемы с драйвером hv_netvsc.
Режим lookahead пытается обеспечить согласованность представления приложения и ядра о кольцах приёма.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_pcap_reinit_frequency
-
добавлено в 2.9
Частота в секундах, с которой периодически запускается проверка 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
-
добавлено в 2.9
Порог для ошибок приёма входных пакетов в режиме pcap, превышение которого запускает pcap reinit.
Если не задано, выполняется безусловное reinit.
Это значение проверяется каждые pcap_reinit_frequency интервалов.
Поле добавлено в 17.2.13, 18.1.3, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_probe_port
-
добавлено в 2.5
Tcp порт на се, где будет выполняться эхо-сервис.
Поле добавлено в 17.2.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 7.
se_remote_punt_udp_port
-
добавлено в 2.4
Порт UDP для пакетов punt в режиме моста Docker.
Поле добавлено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1501.
se_routing
boolean
добавлено в 2.9
    Варианты:
  • no
  • yes
Включить маршрутизацию через датапату сервера сервисов.
При отключении маршрутизация выполняется ядром Linux.
Для того, чтобы маршрутизация се была эффективной, необходимо включить маршрутизацию IP в группе серверов сервисов.
Поле добавлено в 18.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
se_sb_dedicated_core
boolean
добавлено в 2.5
    Варианты:
  • no
  • yes
Трафик sideband будет обрабатываться выделенным ядром.
Поле добавлено в 16.5.2, 17.1.9, 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
se_sb_threads
-
добавлено в 2.5
Количество потоков sideband на один се.
Допустимые значения: 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
-
добавлено в 2.9
Диапазон портов traceroute.
Поле добавлено в 17.2.8.
END_OF_DOCUMENT_MARKER
se_tunnel_mode
-
Определяет, активен ли dsr со вторичного се или нет 0 автоматически определяется на основе типа гипервизора.
1 отключить dsr безусловно.
2 включить dsr безусловно.
Допустимые значения — 0-2.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_tunnel_udp_port
-
Порт UDP для туннелированных пакетов со вторичного на первичный се в режиме docker bridge.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 1550.
se_udp_encap_ipc
-
added in 2.4
Определяет, инкапсулируются ли сообщения se-se ipc в заголовке udp 0 автоматически определяется на основе типа гипервизора.
1 использовать udp инкапсуляцию безусловно.
Допустимые значения — 0-1.
Поле введено в 17.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_use_dpdk
-
added in 2.9
Определяет, должна ли использоваться библиотека dpdk или нет 0 автоматически определяется на основе типа гипервизора 1 использовать dpdk, если pcap не включен 2
не использовать dpdk.
Допустимые значения — 0-2.
Поле введено в 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
se_vs_hb_max_pkts_in_batch
-
Максимальное количество агрегированных пакетов heartbeat vs для отправки в пакет.
Допустимые значения — 1-256.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.
se_vs_hb_max_vs_in_pkt
-
Максимальное количество виртуальных сервисов, для которых сообщения heartbeat агрегируются в одном пакете.
Допустимые значения — 1-1024.
Поле введено в 17.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 256.
self_se_election
boolean
added in 2.9
    Вызовы:
  • нет
  • да
Разрешить се выбирают первичный среди себя в отсутствие подключения к контроллеру.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
service_ip6_subnets
-
added in 2.9
Сегменты IPv6, назначенные группе се.
Необходимы для размещения группы vs.
Поле введено в 18.1.1.
service_ip_subnets
-
Сегменты, назначенные группе се.
Необходимы для размещения группы vs.
Поле введено в 17.1.1.
shm_minimum_config_memory
-
added in 2.9
Минимальный необходимый общий объем памяти для применения любой конфигурации.
Допустимые значения — 0-100.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 4.
significant_log_throttle
-
Эта настройка ограничивает количество значимых журналов, генерируемых в секунду на ядро на этом се.
По умолчанию 100 журналов в секунду.
Установите его в ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
ssl_preprocess_sni_hostname
boolean
added in 2.9
    Вызовы:
  • нет
  • да
(бета) предварительная обработка ssl клиента hello для расширения имени хоста sni.если установлено в true, это применит протокол(ы) ssl дочернего sni, если они отличаются
от разрешенного протокола(ов) ssl родительского sni.
Поле введено в 17.2.12, 18.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
state
-
    Вызовы:
  • отсутствует
  • наличие ←
Состояние, которое должно быть применено к сущности.
tenant
string
По умолчанию:
"admin"
Имя клиента, используемого для всех вызовов API Avi и контекста объекта.
tenant_ref
-
Это ссылка на объект типа клиент.
tenant_uuid
string
По умолчанию:
""
UUID клиента, используемого для всех вызовов API Avi и контекста объекта.
udf_log_throttle
-
Эта настройка ограничивает количество udf журналов, генерируемых в секунду на ядро на этом се.
Журналы Udf генерируются из-за настроенных фильтров журнала клиента или правил с включенным ведением журнала.
По умолчанию 100 журналов в секунду.
Установите его в ноль (0), чтобы отключить ограничение.
Поле введено в 17.1.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 100.
url
-
URL контроллера Avi объекта.
use_standard_alb
boolean
added in 2.9
    Вызовы:
  • нет
  • да
Использовать стандартный балансировщик нагрузки azure.
По умолчанию флаг на уровне облака установлен.
Если не установлен, он наследует/использует флаг use_standard_alb из облака.
Поле введено в 18.2.3.
username
string
По умолчанию:
""
Имя пользователя, используемое для доступа к контроллеру 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
boolean
    Вызовы:
  • нет
  • да
Флаг boolean для установки 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
-
added in 2.9
При установке vip_asg конфигурация vip будет управляться avi.пользователь сможет настроить vip_asg или vips индивидуально во время создания.
Поле введено в 17.2.12, 18.1.2.
vs_host_redundancy
boolean
    Вызовы:
  • нет
  • да
Обеспечить, чтобы первичные и вторичные service engine были развернуты на разных физических хостах.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
vs_scalein_timeout
-
Время ожидания завершения масштабирования входящих се, пока они не освободят существующие потоки, прежде чем помечать масштабирование как завершённое.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scalein_timeout_for_upgrade
-
Во время обновления се, время ожидания масштабирования входящих се, пока они не освободят существующие потоки, прежде чем помечать масштабирование как завершённое.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 30.
vs_scaleout_timeout
-
Время ожидания, пока расширенные се станут готовыми, прежде чем помечать масштабирование как завершённое.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 600.
vs_se_scaleout_additional_wait_time
-
added in 2.9
Время ожидания для отправки уведомления о готовности масштабирования после того, как виртуальная служба была помечена как активная.
В некоторых развертываниях может быть дополнительная задержка для приема трафика.
Например, для bgp требуется некоторое время для объявления маршрутов.
Допустимые значения — от 0 до 20.
Поле введено в 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
vs_se_scaleout_ready_timeout
-
added in 2.9
Таймаут в секундах для того, чтобы виртуальная машина отправила уведомление о готовности масштабирования.
Допустимые значения — от 0 до 60.
Поле введено в 18.1.5, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 25.
vs_switchover_timeout
-
added in 2.9
Во время обновления се в группе се legacy актив/резерв, время ожидания, пока новый основной се примет потоки перед тем как отметить переключение как завершенное.
Поле введено в 17.2.13, 18.1.4, 18.2.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 300.
vss_placement
-
added in 2.5
Параметры для размещения виртуальных сервисов только на подмножестве ядер se.
Поле введено в 17.2.5.
vss_placement_enabled
boolean
added in 2.9
    Choices:
  • нет
  • да
Если установлено, виртуальные сервисы будут размещаться только на подмножестве ядер se.
Поле введено в 18.1.1.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
waf_learning_interval
-
added in 2.9
Частота, с которой se публикует результаты обучения waf.
Допустимые значения — от 1 до 43200.
Поле устарело в 18.2.3.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 10.
waf_learning_memory
-
added in 2.9
Объем памяти, резервируемый на се для обучения waf.
Не может превышать 5% от памяти се.
Поле устарело в 18.2.3.
Поле введено в 18.1.2.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 0.
waf_mempool
boolean
added in 2.5
    Choices:
  • нет
  • да
Включить пул памяти для waf.
Поле введено в 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
waf_mempool_size
-
added in 2.5
Размер пула памяти, используемого для waf.
Поле введено в 17.2.3.
Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 64.

Примечания

Примечание

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

Примеры

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

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

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

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



Статус

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

Авторы

  • 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.9/modules/avi_serviceenginegroup_module.html

Spec-Zone.ru

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