Spec-Zone.ru › Ansible

ngine_io.cloudstack.network module – Управляет сетями в облаках на базе 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.network.

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

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

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

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

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

account

string

Учётная запись, с которой связана сеть.

acl

string

Имя списка управления доступом для уровня сети VPC.

acl_type

string

Тип управления доступом для сети.

Если значение не указано, Cloudstack по умолчанию выберет account для изолированных сетей

и domain для общих сетей.

Учитывается только при создании.

Варианты:

  • "account"
  • "domain"

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.

cidr_ipv6

string

CIDR-диапазон сети IPv6; должен быть не меньше /64.

Учитывается только при создании.

clean_up

boolean

Удалять старые сетевые элементы.

Учитывается только при state=restarted.

Варианты:

  • false ← (по умолчанию)
  • true

display_text

string

Отображаемый текст сети.

Если значение не указано, в качестве display_text будет использовано значение name.

domain

string

Домен, с которым связана сеть.

end_ip

string

Последний IPv4-адрес, принадлежащий сети.

Если значение не указано, используется значение start_ip.

Учитывается только при создании.

end_ipv6

string

Последний IPv6-адрес, принадлежащий сети.

Если значение не указано, используется значение start_ipv6.

Учитывается только при создании.

gateway

string

Шлюз сети.

Обязателен для общих сетей и изолированных сетей, входящих в VPC.

Учитывается только при создании.

gateway_ipv6

string

Шлюз сети IPv6.

Обязателен для общих сетей.

Учитывается только при создании.

isolated_pvlan

string

Изолированная частная VLAN для этой сети.

name

string / обязательный

Имя сети (с учётом регистра).

netmask

string

Маска подсети.

Обязательна для общих сетей и изолированных сетей, входящих в VPC.

Учитывается только при создании.

network_domain

string

Домен сети.

network_offering

string

Имя предложения для сети.

Обязательно, если state=present.

poll_async

boolean

Ожидать завершения асинхронных заданий, проверяя их состояние.

Варианты:

  • false
  • true ← (по умолчанию)

project

string

Имя проекта, в котором будет развёрнута сеть.

start_ip

string

Первый IPv4-адрес, принадлежащий сети.

Учитывается только при создании.

start_ipv6

string

Первый IPv6-адрес, принадлежащий сети.

Учитывается только при создании.

state

string

Состояние сети.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"
  • "restarted"

subdomain_access

boolean

Определяет, разрешено ли поддоменам использовать сети, выделенные для их родительского домена или доменов.

Следует использовать вместе с acl_type=domain.

Учитывается только при создании.

Варианты:

  • false
  • true

tags

псевдонимы: tag

list / элементы=dictionary

Список тегов. Теги представляют собой список словарей с ключами key и value.

Чтобы удалить все теги, задайте пустой список, например tags: [].

validate_certs

boolean

добавлено в ngine_io.cloudstack 2.4.0

Если false, SSL-сертификаты проверяться не будут.

Если значение не задано, учитывается переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на сайтах под вашим контролем, применяющих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

vlan

string

ID или VID сети.

vpc

string

Имя VPC, к которой относится сеть.

zone

string / обязательный

Имя зоны, в которой следует развернуть сеть.

Примечания

Примечание

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

Примеры

- name: Create a network
  ngine_io.cloudstack.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.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.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.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.network:
    name: my network
    zone: zone01
    clean_up: yes
    state: restarted

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

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

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

Ключ

Описание

account

string

Учетная запись, к которой относится сеть.

Возвращается: при успехе

Пример: "example account"

acl

string

Имя списка контроля доступа для уровня сети VPC.

Возвращается: при успехе

Пример: "My ACL"

acl_id

string

Идентификатор списка контроля доступа для уровня сети VPC.

Возвращается: при успехе

Пример: "dfafcd55-0510-4b8c-b6c5-b8cedb4cfd88"

acl_type

string

Тип доступа к сети (Domain, Account).

Возвращается: при успехе

Пример: "Account"

broadcast_domain_type

string

Тип широковещательного домена сети.

Возвращается: при успехе

Пример: "Vlan"

cidr

string

IPv4 CIDR сети.

Возвращается: при успехе

Пример: "10.101.64.0/24"

cidr_ipv6

string

IPv6 CIDR сети.

Возвращается: если доступно

Пример: "2001:db8::/64"

display_text

string

Отображаемый текст сети.

Возвращается: при успехе

Пример: "web project"

dns1

string

IP-адрес первого сервера имен.

Возвращается: при успехе

Пример: "1.2.3.4"

dns2

string

IP-адрес второго сервера имен.

Возвращается: при успехе

Пример: "1.2.3.4"

domain

string

Домен, к которому относится сеть.

Возвращается: при успехе

Пример: "ROOT"

gateway

string

Шлюз IPv4.

Возвращается: при успехе

Пример: "10.101.64.1"

gateway_ipv6

string

Шлюз IPv6.

Возвращается: если доступно

Пример: "2001:db8::1"

id

string

UUID сети.

Возвращается: при успехе

Пример: "04589590-ac63-4ffc-93f5-b698b8ac38b6"

is_persistent

boolean

Является ли сеть постоянной.

Возвращается: при успехе

Пример: false

is_system

boolean

Относится ли сеть к системным.

Возвращается: при успехе

Пример: false

name

string

Имя сети.

Возвращается: при успехе

Пример: "web project"

netmask

string

Маска подсети IPv4.

Возвращается: при успехе

Пример: "255.255.255.0"

network_domain

string

Домен сети

Возвращается: при успехе

Пример: "example.local"

network_offering

string

Имя предложения сети.

Возвращается: при успехе

Пример: "DefaultIsolatedNetworkOfferingWithSourceNatService"

network_offering_availability

string

Доступность предложения сети, на основе которого создана сеть

Возвращается: при успехе

Пример: "Optional"

network_offering_conserve_mode

boolean

Включен ли в предложении сети режим экономии IP-адресов.

Возвращается: при успехе

Пример: false

network_offering_display_text

string

Отображаемый текст предложения сети.

Возвращается: при успехе

Пример: "Offering for Isolated Vpc networks with Source Nat service enabled"

project

string

Имя проекта.

Возвращается: при успехе

Пример: "Production"

state

string

Состояние сети (Allocated, Implemented, Setup).

Возвращается: при успехе

Пример: "Allocated"

tags

list / elements=string

Список тегов ресурсов, связанных с сетью.

Возвращается: при успехе

Пример: ["[ { \"key\": \"foo\"", " \"value\": \"bar\" } ]"]

traffic_type

string

Тип трафика сети.

Возвращается: при успехе

Пример: "Guest"

type

string

Тип сети.

Возвращается: при успехе

Пример: "Isolated"

vpc

string

Имя VPC.

Возвращается: если доступно

Пример: "My VPC"

zone

string

Имя зоны.

Возвращается: при успехе

Пример: "ch-gva-2"

Авторы

  • René Moser (@resmo)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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/network_module.html

Spec-Zone.ru

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