Spec-Zone.ru › Ansible

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

Примечание

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

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

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

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

Новая версия в ngine_io.cloudstack 0.1.0

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

Описание

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

Требования

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

  • 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 / required

API-ключ CloudStack API.

Если не указано, используется переменная окружения CLOUDSTACK_KEY.

api_secret

string / required

Секретный ключ CloudStack API.

Если не указано, используется переменная окружения CLOUDSTACK_SECRET.

api_timeout

integer

Таймаут HTTP в секундах.

Если не указано, используется переменная окружения CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

string / required

URL CloudStack API, например 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

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

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

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 / required

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

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

aliases: tag

list / elements=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.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

string

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

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

Пример: "example account"

acl

string

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

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

Пример: "My ACL"

acl_id

string

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

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

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

acl_type

string

Тип доступа к сети (Домен, Учетная запись).

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

Пример: "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"

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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_network_module.html

Spec-Zone.ru

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