Модуль ngine_io.cloudstack.physical_network — управление физическими сетями в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для работы с этим модулем могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.physical_network.

Добавлено в ngine_io.cloudstack 0.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание, обновление и удаление сетей.
Включение и отключение поставщиков сетевых служб.
Включение внутренних балансировщиков нагрузки и элементов VPC/VirtualRouter по мере необходимости.

Псевдонимы: cs_physical_network

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
api_http_method string	HTTP-метод, используемый для отправки запросов к конечной точке API. Если не задан, используется переменная окружения `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (по умолчанию) `"post"`
api_key string / обязательно	Ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_KEY`.
api_secret string / обязательно	Секретный ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_SECRET`.
api_timeout integer	Тайм-аут HTTP в секундах. Если не задан, используется переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url string / обязательно	URL API CloudStack, например https://cloud.example.com/client/api. Если не задан, используется переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert string	Проверять файл сертификата центра сертификации. Если не задан, используется переменная окружения `CLOUDSTACK_VERIFY`.
broadcast_domain_range string	Диапазон широковещательного домена для физической сети [Pod или Zone]. Варианты: `"POD"` `"ZONE"`
domain string	Домен, которому принадлежит сеть.
isolation_method string	Метод изоляции физической сети. Варианты: `"VLAN"` `"VXLAN"` `"GRE"` `"L3"`
name псевдонимы: physical_network string / обязательно	Имя физической сети.
network_speed string	Скорость физической сети. Варианты: `"1G"` `"10G"`
nsps_disabled list / элементы=string	Список поставщиков сетевых служб, которых нужно отключить.
nsps_enabled list / элементы=string	Список поставщиков сетевых служб, которых нужно включить.
poll_async boolean	Опрос асинхронных заданий до их завершения. Варианты: `false` `true` ← (по умолчанию)
state string	Состояние физической сети. Варианты: `"present"` ← (по умолчанию) `"absent"` `"disabled"` `"enabled"`
tags псевдонимы: tag string	Метка для идентификации этой сети. Для физических сетей поддерживается только одна метка. Чтобы удалить существующую метку, передайте пустую строку.
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если `false`, сертификаты SSL не будут проверяться. Если не задана, используется переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Этот параметр следует использовать только на сайтах под личным контролем, где применяются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vlan string	Диапазоны VLAN/VNI физической сети.
zone string / обязательно	Имя зоны, к которой относится сеть.

Примечания

Примечание

Подробное руководство по модулям CloudStack приведено в руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Ensure a network is present
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    isolation_method: VLAN
    broadcast_domain_range: ZONE

- name: Set a tag on a network
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    tag: overlay

- name: Remove tag on a network
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    tag: ""

- name: Ensure a network is enabled with specific nsps enabled
  ngine_io.cloudstack.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 enabled with VXLAN isolation
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    isolation_method: VXLAN
    vlan: 42-8192
    broadcast_domain_range: ZONE
    state: enabled

- name: Ensure a network is disabled
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    state: disabled

- name: Ensure a network is enabled
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    state: enabled

- name: Ensure a network is absent
  ngine_io.cloudstack.physical_network:
    name: net01
    zone: zone01
    state: absent

Возвращаемые значения

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

Ключ	Описание
broadcast_domain_range string	Диапазон широковещательного домена сети [POD / ZONE]. Возвращается: при успешном выполнении Пример: `"ZONE"`
domain string	Имя домена, в котором находится сеть. Возвращается: при успешном выполнении Пример: `"domain1"`
id string	UUID сети. Возвращается: при успешном выполнении Пример: `"3f8f25cd-c498-443f-9058-438cfbcbff50"`
isolation_method string	Метод изоляции сети [VLAN/VXLAN/GRE/L3]. Возвращается: при успешном выполнении Пример: `"VLAN"`
name string	Имя сети. Возвращается: при успешном выполнении Пример: `"net01"`
network_speed string	Скорость сети [1G/10G]. Возвращается: при успешном выполнении Пример: `"1G"`
nsps complex	Список включенных или отключенных поставщиков сетевых служб Возвращается: при включении/отключении поставщиков сетевых служб
disabled list / элементы=string	Список отключенных поставщиков сетевых служб Возвращается: при отключении поставщика сетевых служб Пример: `["internallbvm"]`
enabled list / элементы=string	Список включенных поставщиков сетевых служб Возвращается: при включении поставщика сетевых служб Пример: `["virtualrouter"]`
state string	Состояние сети [включена/отключена]. Возвращается: при успешном выполнении Пример: `"Enabled"`
zone string	Имя зоны, в которой находится физическая сеть. Возвращается: при успешном выполнении Пример: `"ch-gva-2"`

Авторы

Netservers Ltd. (@netservers)
Patryk Cichy (@PatTheSilent)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/physical_network_module.html