Spec-Zone.ru › Ansible

ngine_io.cloudstack.cs_network_offering модуль — Управляет предложениями сети в облаках на основе 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_offering.

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

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

Обзор

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

api_http_method

строка

Метод HTTP, используемый для запроса к API-точке.

Если не указано, используется переменная среды CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

строка / обязательно

Ключ API для CloudStack API.

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

api_secret

строка / обязательно

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

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

api_timeout

целое число

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

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

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

api_url

строка / обязательно

URL CloudStack API, например: https://cloud.example.com/client/api.

Если не указано, используется переменная среды CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

строка

Проверка сертификата авторитета CA.

Если не указано, используется переменная среды CLOUDSTACK_VERIFY.

availability

строка

Доступность сетевого предложения. Значение по умолчанию — необязательно

conserve_mode

логическое

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

Варианты:

  • false
  • true

details

список / элементы=словарь

Подробные данные о сетевом предложении в формате ключ/значение.

с поставщиком услуг в качестве значения

display_text

строка

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

domains

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

список / элементы=строка

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

Список доменов, к которым относится сетевое предложение.

Используйте public для общедоступных предложений.

egress_default_policy

строка

Политика выходящего трафика по умолчанию — разрешить или запретить.

Варианты:

  • "allow"
  • "deny"

for_vpc

логическое

Предназначено ли предложение для использования в VPC.

Варианты:

  • false
  • true

guest_ip_type

строка

Тип гостевого IP-адреса сетевого предложения.

Варианты:

  • "Shared"
  • "Isolated"

keepalive_enabled

логическое

Если значение истинно, keepalive будет включён в балансировщике нагрузки.

На момент написания это имеет эффект только на haproxy.

В файле конфигурации haproxy параметры mode http и httpclose сброшены.

Варианты:

  • false
  • true

max_connections

целое число

Максимальное количество одновременных подключений, поддерживаемых сетевым предложением.

name

строка / обязательно

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

network_rate

целое число

Скорость передачи данных в мегабитах в секунду.

persistent

логическое

Истинно, если сетевое предложение поддерживает постоянные сети.

По умолчанию ложно, если не указано.

Варианты:

  • false
  • true

service_capabilities

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

список / элементы=строка

Требуемые возможности служб в рамках сетевого предложения.

service_offering

string

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

service_providers

aliases: service_provider

список / элементы=словарь

Сопоставление поставщика с услугой.

Если не указано, поставщик услуги будет сопоставлен с поставщиком по умолчанию на физической сети.

specify_ip_ranges

логическое

Поддерживает ли предложение по сети указание диапазонов IP-адресов.

По умолчанию установлено значение no API, если не указано.

Вызовы:

  • false
  • true

specify_vlan

логическое

Поддерживает ли предложение по сети VLAN.

Вызовы:

  • false
  • true

state

строка

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

Вызовы:

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

supported_services

aliases: supported_service

список / элементы=строка

Поддерживаемые услуги предложения по сети.

Список одного или нескольких элементов из списка выбора.

Вызовы:

  • "Dns"
  • "PortForwarding"
  • "Dhcp"
  • "SourceNat"
  • "UserData"
  • "Firewall"
  • "StaticNat"
  • "Vpn"
  • "Lb"
  • "NetworkACL"
  • "SecurityGroup"
  • "Connectivity"
  • "BaremetalPxeService"

tags

aliases: tag

список / элементы=строка

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

Список тегов. Теги — это список строк.

Для удаления всех тегов задайте пустой список, например, tags: [].

traffic_type

строка

Тип трафика для предложения по сети.

По умолчанию: "Guest"

validate_certs

логическое

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

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

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

Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов.

Вызовы:

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

zones

aliases: zone

список / элементы=строка

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

Список зон, к которым относится предложение по сети.

Используйте all для всех зон предложения.

Примечания

Примечание

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

Примеры

- name: Create a network offering and enable it
  ngine_io.cloudstack.cs_network_offering:
    name: my_network_offering
    display_text: network offering description
    state: enabled
    guest_ip_type: Isolated
    supported_services:
      - Dns
      - PortForwarding
      - Dhcp
      - SourceNat
      - UserData
      - Firewall
      - StaticNat
      - Vpn
      - Lb
      - NetworkACL
      - SecurityGroup
      - Connectivity
      - BaremetalPxeService
    service_providers:
      - { service: 'dns', provider: 'virtualrouter' }
      - { service: 'dhcp', provider: 'virtualrouter' }

- name: Remove a network offering
  ngine_io.cloudstack.cs_network_offering:
    name: my_network_offering
    state: absent

Значения возврата

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

Key

Description

availability

string

Доступность предложения сети.

Returned: success

Sample: "Optional"

display_text

string

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

Returned: success

Sample: "My network offering"

domains

list / elements=string

added in ngine_io.cloudstack 2.2.0

Список доменов, связанных с предложением сети.

Returned: success

Sample: ["public"]

egress_default_policy

string

Политика исходящего трафика по умолчанию.

Returned: success

Sample: "allow"

for_vpc

boolean

Предназначено ли предложение для использования с VPC или нет.

Returned: success

Sample: false

guest_ip_type

string

Тип гостевого IP адреса предложения сети.

Returned: success

Sample: "Isolated"

id

string

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

Returned: success

Sample: "a6f7a5fc-43f8-11e5-a151-feff819cdc9f"

is_default

boolean

Является ли предложение сети предложением по умолчанию или нет.

Returned: success

Sample: false

is_persistent

boolean

Поддерживаются ли постоянные сети или нет.

Returned: success

Sample: false

max_connections

integer

Максимальное количество одновременных соединений, которые могут обрабатываться балансировщиком нагрузки.

Returned: success

Sample: 300

name

string

Название предложения сети.

Returned: success

Sample: "MyCustomNetworkOffering"

network_rate

integer

Скорость передачи сетевого трафика в Мбит/с.

Returned: success

Sample: 200

service_offering_id

string

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

Returned: success

Sample: "c5f7a5fc-43f8-11e5-a151-feff819cdc9f"

state

string

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

Returned: success

Sample: "Enabled"

tags

list / elements=string

added in ngine_io.cloudstack 2.2.0

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

Returned: success

Sample: ["tag1", "tag2"]

traffic_type

string

Тип трафика.

Returned: success

Sample: "Guest"

zones

list / elements=string

added in ngine_io.cloudstack 2.2.0

Список зон, связанных с предложением сети.

Returned: success

Sample: ["all"]

Авторы

  • David Passante (@dpassante)

Ссылки на сборку

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

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

Spec-Zone.ru

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