ngine_io.cloudstack.cs_network – Управляет сетями в облаках на основе Apache CloudStack.

Примечание

Этот плагин входит в состав коллекции ngine_io.cloudstack (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.

Для использования в playbook, укажите: ngine_io.cloudstack.cs_network.

В версии 0.1.0: плагина ngine_io.cloudstack

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создание, обновление, перезапуск и удаление сетей.

Требования

Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется данный модуль.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account строка		Аккаунт, к которому относится сеть.
acl строка		Имя списка управления доступом для уровня сети VPC.
acl_type строка	Варианты: account domain	Тип управления доступом для сети. Если не указано, CloudStack по умолчанию использует `account` для изолированных сетей и `domain` для общих сетей. Применяется только при создании.
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`.
cidr_ipv6 строка		CIDR IPv6 сети, должна быть не менее /64. Применяется только при создании.
clean_up булево	Варианты: нет ← да	Очистка старых элементов сети. Применяется только при state=restarted.
display_text строка		Текст отображения сети. Если не указано, используется name в качестве display_text.
domain строка		Домен, к которому относится сеть.
end_ip строка		Конечный IPv4-адрес сети. Если не указано, используется значение start_ip. Применяется только при создании.
end_ipv6 строка		Конечный IPv6-адрес сети. Если не указано, используется значение start_ipv6. Применяется только при создании.
gateway строка		Шлюз сети. Требуется для общих сетей и изолированных сетей, если они принадлежат VPC. Применяется только при создании.
gateway_ipv6 строка		Шлюз IPv6-сети. Требуется для общих сетей. Применяется только при создании.
isolated_pvlan строка		Изолированная частная VLAN для этой сети.
name строка / обязательно		Имя сети (регистрозависимое).
netmask строка		Маска сети. Требуется для общих сетей и изолированных сетей, если они принадлежат VPC. Применяется только при создании.
network_domain строка		Домен сети.
network_offering строка		Название предложения для сети. Требуется, если state=present.
poll_async булево	Варианты: нет да ←	Проверять асинхронные задачи до завершения.
project строка		Имя проекта, в котором будет развернута сеть.
start_ip строка		Начальный IPv4-адрес сети. Применяется только при создании.
start_ipv6 строка		Начальный IPv6-адрес сети. Применяется только при создании.
state строка	Варианты: present ← absent restarted	Состояние сети.
subdomain_access булево	Варианты: нет да	Определяет, разрешено ли дочерним доменам использовать сети, выделенные для их родительских доменов. Должно использоваться с acl_type=domain. Применяется только при создании.
tags список / элементы=словарь		Список тегов. Теги представлены списком словарей с ключами key и value. Для удаления всех тегов установите пустой список, например, tags: []. псевдонимы: тег
vlan строка		Идентификатор или VID сети.
vpc строка		Имя VPC сети.
zone строка / обязательно		Имя зоны, в которой должна быть развернута сеть.

Примечания

Примечание

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

Примеры

- name: Create a network
  ngine_io.cloudstack.cs_network:
    name: my network
    zone: gva-01
    network_offering: DefaultIsolatedNetworkOfferingWithSourceNatService
    network_domain: example.com

- name: Create a network with start and end IP
  ngine_io.cloudstack.cs_network:
    name: Private Network
    network_offering: PrivNet
    start_ip: 10.12.9.10
    end_ip: 10.12.9.100
    netmask: 255.255.255.0
    zone: gva-01

- name: Create a VPC tier
  ngine_io.cloudstack.cs_network:
    name: my VPC tier 1
    zone: gva-01
    vpc: my VPC
    network_offering: DefaultIsolatedNetworkOfferingForVpcNetworks
    gateway: 10.43.0.1
    netmask: 255.255.255.0
    acl: my web acl

- name: Update a network
  ngine_io.cloudstack.cs_network:
    name: my network
    zone: zone01
    display_text: network of domain example.local
    network_domain: example.local

- name: Restart a network with clean up
  ngine_io.cloudstack.cs_network:
    name: my network
    zone: zone01
    clean_up: yes
    state: restarted

- name: Remove a network
  ngine_io.cloudstack.cs_network:
    name: my network
    zone: zone01
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
account строка	успех	Аккаунт, к которому относится сеть. Пример: example account
acl строка	успех	Имя списка управления доступом (ACL) для уровня сети VPC. Пример: Мой ACL
acl_id строка	успех	Идентификатор списка управления доступом (ACL) для уровня сети VPC. Пример: dfafcd55-0510-4b8c-b6c5-b8cedb4cfd88
acl_type строка	успех	Тип доступа сети (Домен, Аккаунт). Пример: Аккаунт
broadcast_domain_type строка	успех	Тип домена широковещательной передачи сети. Пример: Vlan
cidr строка	успех	CIDR IPv4 сети. Пример: 10.101.64.0/24
cidr_ipv6 строка	если доступно	CIDR IPv6 сети. Пример: 2001:db8::/64
display_text строка	успех	Текст для отображения сети. Пример: web project
dns1 строка	успех	IP-адрес первого сервера имен. Пример: 1.2.3.4
dns2 строка	успех	IP-адрес второго сервера имен. Пример: 1.2.3.4
domain строка	успех	Домен, к которому относится сеть. Пример: ROOT
gateway строка	успех	IPv4 шлюз. Пример: 10.101.64.1
gateway_ipv6 строка	если доступно	IPv6 шлюз. Пример: 2001:db8::1
id строка	успех	UUID сети. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6
is_persistent логический тип	успех	Является ли сеть постоянной.
is_system логический тип	успех	Является ли сеть связанной с системой.
name строка	успех	Имя сети. Пример: web project
netmask строка	успех	IPv4 маска сети. Пример: 255.255.255.0
network_domain строка	успех	Домен сети. Пример: example.local
network_offering строка	успех	Имя предложения сети. Пример: DefaultIsolatedNetworkOfferingWithSourceNatService
network_offering_availability строка	успех	Доступность предложения сети, из которого создана сеть. Пример: Необязательно
network_offering_conserve_mode логический тип	успех	Включен ли режим сохранения IP в предложении сети.
network_offering_display_text строка	успех	Текст для отображения предложения сети. Пример: Предложение для изолированных сетей VPC с включенной службой Source Nat
project строка	успех	Имя проекта. Пример: Production
state строка	успех	Состояние сети (Выделено, Реализовано, Настроено). Пример: Выделено
tags список / элементы=строка	успех	Список тегов ресурсов, связанных с сетью. Пример: [ { "ключ": "foo", "значение": "bar" } ]
traffic_type строка	успех	Тип трафика сети. Пример: Гость
type строка	успех	Тип сети. Пример: Изолированная
vpc строка	если доступно	Имя VPC. Пример: Моя VPC
zone строка	успех	Имя зоны. Пример: ch-gva-2

Авторы

René Moser (@resmo)

© 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_network_module.html