avi_cloud – Модуль для настройки облачного объекта Avi RESTful
Новая версия с 2.4.
Описание
- Этот модуль используется для настройки облачного объекта
- больше примеров по адресу https://github.com/avinetworks/devops
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- avisdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_context словарь добавлен в 2.5 | Контекст API Avi, включающий текущий идентификатор сеанса и токен CSRF. Это позволяет пользователю выполнить единый вход и повторно использовать сеанс. | |
| api_version строка | Значение по умолчанию: "16.4.4" | Версия API Avi, используемая для Avi API и объектов. |
| apic_configuration - | Настройки apicconfiguration для облака. | |
| apic_mode булево |
| Булевый флаг для установки apic_mode. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как False. |
| avi_api_patch_op - добавлен в 2.5 |
| Операция патчинга, используемая при использовании avi_api_update_method как патч. |
| avi_api_update_method - добавлен в 2.5 |
| Метод по умолчанию для обновления объекта — HTTP PUT. Установка на патч переопределит это поведение, чтобы использовать HTTP PATCH. |
| avi_credentials словарь добавлен в 2.5 | Словарь Avi Credentials, который можно использовать вместо перечисления данных входа в Avi Controller. | |
| aws_configuration - | Настройки awsconfiguration для облака. | |
| azure_configuration - добавлен в 2.5 | Поле введено в 17.2.1. | |
| cloudstack_configuration - | Настройки cloudstackconfiguration для облака. | |
| controller строка | Значение по умолчанию: "" | IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная среды AVI_CONTROLLER. |
| custom_tags - добавлен в 2.5 | Пользовательские теги для всех созданных ресурсов avi в инфраструктуре облака. Поле введено в 17.1.5. | |
| dhcp_enabled булево |
| Выбор схемы управления IP-адресами. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как False. |
| dns_provider_ref - | DNS-профиль для облака. Это ссылка на объект типа ipamdnsproviderprofile. | |
| docker_configuration - | Настройки dockerconfiguration для облака. | |
| east_west_dns_provider_ref - | DNS-профиль для сетей восток-запад. Это ссылка на объект типа ipamdnsproviderprofile. | |
| east_west_ipam_provider_ref - | Профиль ipam для сетей восток-запад. Предупреждение — используйте виртуальные подсети в этом профиле ipam, которые не конфликтуют с подсетями основной сети или любыми накладными сетями в кластере. Например, в aws и gcp используется 169.254.0.0/16 для хранения метаданных экземпляров. Поэтому его не следует использовать в этом профиле. Это ссылка на объект типа ipamdnsproviderprofile. | |
| enable_vip_static_routes булево |
| Использовать статические маршруты для разрешения сети стороны vip во время размещения virtualservice. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как False. |
| ipam_provider_ref - | Профиль ipam для облака. Это ссылка на объект типа ipamdnsproviderprofile. | |
| license_tier - добавлен в 2.5 | Указывает уровень лицензии по умолчанию, который будет использоваться новыми группами se. Это поле по умолчанию наследует значение из системной конфигурации. Варианты перечисления — ENTERPRISE_16, ENTERPRISE_18. Поле введено в 17.2.5. | |
| license_type - | Если тип лицензии не указан, выбирается политика принудительного применения лицензии по умолчанию для типа облака. Настройки по умолчанию — контейнерное облако — максимальное количество ses, openstack и vmware — ядра, linux — сокеты. Варианты перечисления — LIC_BACKEND_SERVERS, LIC_SOCKETS, LIC_CORES, LIC_HOSTS, LIC_SE_BANDWIDTH. | |
| linuxserver_configuration - | Настройки linuxserverconfiguration для облака. | |
| mesos_configuration - | Настройки mesosconfiguration для облака. | |
| mtu - | Настройка mtu для облака. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как 1500. Единицы (байты). | |
| name - / обязательно | Имя объекта. | |
| nsx_configuration - | Параметры конфигурации для nsx-менеджера. Поле введено в 17.1.1. | |
| obj_name_prefix - | Префикс по умолчанию для всех автоматически созданных объектов в данном облаке. Этот префикс можно переопределить в шаблоне группы се. | |
| openstack_configuration - | Настройки openstackconfiguration для облака. | |
| oshiftk8s_configuration - | Настройки oshiftk8sconfiguration для облака. | |
| password строка | Значение по умолчанию: "" | Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная среды AVI_PASSWORD. |
| prefer_static_routes булево |
| Предпочитать статические маршруты маршрутам интерфейса во время размещения virtualservice. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как False. |
| proxy_configuration - | Настройки proxyconfiguration для облака. | |
| rancher_configuration - | Настройки rancherconfiguration для облака. | |
| state - |
| Состояние, которое должно быть применено к сущности. |
| state_based_dns_registration булево добавлен в 2.5 |
| Записи DNS для vip добавляются/удаляются в зависимости от операционного состояния vip. Поле введено в 17.1.12. Значение по умолчанию, если не указано в API или модуле, Avi Controller интерпретирует как True. |
| tenant строка | Значение по умолчанию: "admin" | Имя клиента, используемого для всех вызовов Avi API и контекста объекта. |
| tenant_ref - | Это ссылка на объект типа tenant. | |
| tenant_uuid string | Значение по умолчанию: "" | UUID арендатора, используемый для всех вызовов API Avi и контекста объекта. |
| url - | URL контроллера Avi для объекта. | |
| username string | Значение по умолчанию: "" | Имя пользователя, используемое для доступа к контроллеру Avi. Значение по умолчанию — переменная среды AVI_USERNAME. |
| uuid - | Уникальный идентификатор объекта. | |
| vca_configuration - | Параметры конфигурации vcloudair для облака. | |
| vcenter_configuration - | Параметры конфигурации vcenter для облака. | |
| vtype - / обязательно | Тип облака. Варианты перечисления - CLOUD_NONE, CLOUD_VCENTER, CLOUD_OPENSTACK, CLOUD_AWS, CLOUD_VCA, CLOUD_APIC, CLOUD_MESOS, CLOUD_LINUXSERVER, CLOUD_DOCKER_UCP, CLOUD_RANCHER, CLOUD_OSHIFT_K8S, CLOUD_AZURE. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как CLOUD_NONE. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Avi Network см. на странице https://www.ansible.com/ansible-avi-networks.
Примеры
- name: Create a VMWare cloud with write access mode
avi_cloud:
username: '{{ username }}'
controller: '{{ controller }}'
password: '{{ password }}'
apic_mode: false
dhcp_enabled: true
enable_vip_static_routes: false
license_type: LIC_CORES
mtu: 1500
name: VCenter Cloud
prefer_static_routes: false
tenant_ref: admin
vcenter_configuration:
datacenter_ref: /api/vimgrdcruntime/datacenter-2-10.10.20.100
management_network: /api/vimgrnwruntime/dvportgroup-103-10.10.20.100
password: password
privilege: WRITE_ACCESS
username: user
vcenter_url: 10.10.20.100
vtype: CLOUD_VCENTER
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| obj словарь | успех, изменение | Объект облака (api/cloud) |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.8/modules/avi_cloud_module.html