ngine_io.cloudstack.cs_physical_network – Управляет физическими сетями в облаках на базе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в плейбуке укажите: ngine_io.cloudstack.cs_physical_network.
Новое в версии 0.1.0: плагина ngine_io.cloudstack
Обзор
- Создание, обновление и удаление сетей.
- Включение и отключение поставщиков сетевых услуг.
- Включение необходимых элементов Internal LoadBalancer и VPC/VirtualRouter.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| Метод HTTP, используемый для запроса к API-точке. Если не указан, используется переменная окружения CLOUDSTACK_METHOD. |
| api_key строка / обязательный | Ключ API CloudStack API. Если не указан, используется переменная окружения CLOUDSTACK_KEY. | |
| api_secret строка / обязательный | Секретный ключ CloudStack API. Если не указан, используется переменная окружения CLOUDSTACK_SECRET. | |
| api_timeout целое число | Значение по умолчанию: 10 | Таймаут HTTP в секундах. Если не указан, используется переменная окружения CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательный | URL CloudStack API, например https://cloud.example.com/client/api. Если не указан, используется переменная окружения CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверять сертификат авторитета CA. Если не указан, используется переменная окружения CLOUDSTACK_VERIFY. | |
| broadcast_domain_range строка |
| Диапазон broadcast-домена для физической сети (Pod или Zone). |
| domain строка | Домен, к которому принадлежит сеть. | |
| isolation_method строка |
| Метод изоляции для физической сети. |
| name строка / обязательный | Имя физической сети. псевдонимы: physical_network | |
| network_speed строка |
| Скорость физической сети. |
| nsps_disabled список / элементы=строка | Список поставщиков сетевых услуг для отключения. | |
| nsps_enabled список / элементы=строка | Список поставщиков сетевых услуг для включения. | |
| poll_async булево |
| Ожидать завершения асинхронных задач. |
| state строка |
| Состояние физической сети. |
| tags строка | Тег для идентификации этой сети. Физические сети поддерживают только один тег. Для удаления существующего тега передайте пустую строку. псевдонимы: tag | |
| vlan строка | Диапазоны VLAN/VNI физической сети. | |
| zone строка / обязательный | Имя зоны, к которой принадлежит сеть. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Ensure a network is present
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
isolation_method: VLAN
broadcast_domain_range: ZONE
- name: Set a tag on a network
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
tag: overlay
- name: Remove tag on a network
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
tag: ""
- name: Ensure a network is enabled with specific nsps enabled
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
isolation_method: VLAN
vlan: 100-200,300-400
broadcast_domain_range: ZONE
state: enabled
nsps_enabled:
- virtualrouter
- internallbvm
- vpcvirtualrouter
- name: Ensure a network is disabled
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
state: disabled
- name: Ensure a network is enabled
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
state: enabled
- name: Ensure a network is absent
ngine_io.cloudstack.cs_physical_network:
name: net01
zone: zone01
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в документе, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| broadcast_domain_range строка | успех | диапазон broadcastdomain сети [POD / ZONE]. Пример: ZONE | |
| domain строка | успех | Имя домена, в котором находится сеть. Пример: domain1 | |
| id строка | успех | UUID сети. Пример: 3f8f25cd-c498-443f-9058-438cfbcbff50 | |
| isolation_method строка | успех | метод изоляции сети [VLAN/GRE/L3]. Пример: VLAN | |
| name строка | успех | Имя сети. Пример: net01 | |
| network_speed строка | успех | скорость сети [1G/10G]. Пример: 1G | |
| nsps сложный тип | при включении/выключении поставщиков сетевых услуг | список включенных или отключенных поставщиков сетевых услуг | |
| disabled список / элементы=строка | при отключении поставщика сетевых услуг | список поставщиков сетевых услуг, которые были отключены Пример: ['internallbvm'] | |
| enabled список / элементы=строка | при включении поставщика сетевых услуг | список поставщиков сетевых услуг, которые были включены Пример: ['virtualrouter'] | |
| state строка | успех | Состояние сети [Включено/Выключено]. Пример: Включено | |
| zone строка | успех | Имя зоны, в которой находится физическая сеть. Пример: ch-gva-2 | |
Авторы
- Netservers Ltd. (@netservers)
- Patryk Cichy (@PatTheSilent)
© 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/ngine_io/cloudstack/cs_physical_network_module.html