Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • get ←
  • post
Метод 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
строка
    Варианты:
  • POD
  • ZONE
Диапазон broadcast-домена для физической сети (Pod или Zone).
domain
строка
Домен, к которому принадлежит сеть.
isolation_method
строка
    Варианты:
  • VLAN
  • GRE
  • L3
Метод изоляции для физической сети.
name
строка / обязательный
Имя физической сети.

псевдонимы: physical_network
network_speed
строка
    Варианты:
  • 1G
  • 10G
Скорость физической сети.
nsps_disabled
список / элементы=строка
Список поставщиков сетевых услуг для отключения.
nsps_enabled
список / элементы=строка
Список поставщиков сетевых услуг для включения.
poll_async
булево
    Варианты:
  • нет
  • да ←
Ожидать завершения асинхронных задач.
state
строка
    Варианты:
  • present ←
  • absent
  • disabled
  • enabled
Состояние физической сети.
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

Spec-Zone.ru

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