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 для использования с API Avi и объектами. |
| apic_configuration | Настройки apicconfiguration для облака. | |
| apic_mode bool |
| Логический флаг для установки apic_mode. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False. |
| avi_api_patch_op (добавлено в 2.5) |
| Операция исправления для использования при использовании avi_api_update_method как patch. |
| avi_api_update_method (добавлено в 2.5) |
| Метод по умолчанию для обновления объекта — HTTP PUT. Установка в patch переопределит это поведение, чтобы использовать HTTP PATCH. |
| avi_credentials (добавлено в 2.5) | Словарь Avi Credentials, который может быть использован вместо перечисления данных входа в контроллер Avi. | |
| 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 bool |
| Выберите схему управления IP-адресами. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 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 bool |
| Использовать статические маршруты для разрешения сетевого адреса vip во время размещения виртуальных служб. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False. |
| ipam_provider_ref | Профиль Ipam для облака. Это ссылка на объект типа ipamdnsproviderprofile. | |
| license_tier (добавлено в 2.5) | Указывает уровень лицензии по умолчанию, который будет использоваться новыми группами se. Это поле по умолчанию наследует значение из системной конфигурации. Варианты перечисления — ENTERPRISE_16, ENTERPRISE_18. Поле введено в 17.2.5. | |
| license_type | Если тип лицензии не указан, выбирается политика применения лицензии по умолчанию для типа облака. Стандартные соответствия — для контейнерных облаков — максимальные сеансы, для 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 как 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 bool |
| Предпочитать статические маршруты по сравнению с маршрутами интерфейса во время размещения виртуальных служб. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False. |
| proxy_configuration | Настройки proxyconfiguration для облака. | |
| rancher_configuration | Настройки rancherconfiguration для облака. | |
| state |
| Состояние, которое должно быть применено к сущности. |
| state_based_dns_registration bool (добавлено в 2.5) |
| Записи DNS для vip добавляются/удаляются в зависимости от операционного состояния vip. Поле введено в 17.1.12. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True. |
| tenant | По умолчанию: "admin" | Имя клиента, используемого для всех вызовов API Avi и контекста объекта. |
| tenant_ref | Это ссылка на объект типа клиент. | |
| tenant_uuid | По умолчанию: "" | UUID клиента, используемого для всех вызовов API Avi и контекста объекта. |
| url | URL контроллера Avi объекта. | |
| username | По умолчанию: "" | Имя пользователя для доступа к контроллеру Avi. Значение по умолчанию — переменная среды AVI_USERNAME. |
| uuid | Уникальный идентификатор объекта. | |
| vca_configuration | Настройки vcloudairconfiguration для облака. | |
| vcenter_configuration | Настройки vcenterconfiguration для облака. | |
| 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 см. на странице 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 dict | success, changed | Объект облака (api/cloud) |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в Поддержка и обслуживание модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Gaurav Rastogi (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.6/modules/avi_cloud_module.html