Spec-Zone.ru › Ansible 2.6

cs_network_offering - Управляет предложениями сетей в облаках на основе Apache CloudStack.

Новое в версии 2.5.

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

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

Требования

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

  • python >= 2.6
  • cs >= 0.6.10

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
api_http_method
    Варианты:
  • get
  • post
HTTP-метод, используемый для запроса конечной точки API.
Если не указано, используется значение переменной среды CLOUDSTACK_METHOD.
В качестве последнего варианта, значение берется из конфигурационного файла ini, см. также примечания.
Значение по умолчанию — get, если не указано.
api_key
Ключ API CloudStack API.
Если не указано, используется значение переменной среды CLOUDSTACK_KEY.
В качестве последнего варианта, значение берется из конфигурационного файла ini, см. также примечания.
api_region По умолчанию:
"cloudstack"
Имя раздела ini в файле cloustack.ini.
Если не указано, используется значение переменной среды CLOUDSTACK_REGION.
api_secret
Секретный ключ CloudStack API.
Если не задано, используется значение переменной среды CLOUDSTACK_SECRET.
В качестве последнего варианта, значение берется из конфигурационного файла ini, см. также примечания.
api_timeout
Таймаут HTTP в секундах.
Если не указано, используется значение переменной среды CLOUDSTACK_TIMEOUT.
В качестве последнего варианта, значение берется из конфигурационного файла ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
api_url
URL CloudStack API, например, https://cloud.example.com/client/api.
Если не указано, используется значение переменной среды CLOUDSTACK_ENDPOINT.
В качестве последнего варианта, значение берется из конфигурационного файла ini, см. также примечания.
availability
Доступность предложения сети. Значение по умолчанию — Optional
conserve_mode
bool
    Варианты:
  • no
  • yes
Включен ли режим сохранения IP для предложения сети.
details
    Варианты:
  • internallbprovider
  • publiclbprovider
Детали предложения сети в парах ключ-значение.
с поставщиком услуг в качестве значения
display_text
Текстовое представление предложений сетей.
egress_default_policy
    Варианты:
  • allow
  • deny
Установлено ли значение политики выходящего трафика по умолчанию на allow или deny.
guest_ip_type
    Варианты:
  • Shared
  • Isolated
Тип гостевой системы предложения сети.
keepalive_enabled
bool
    Варианты:
  • no
  • yes
Если true, keepalive будет включен в балансировщике нагрузки.
На момент написания этого документа, это имеет эффект только для haproxy.
режимы http и httpclose не установлены в файле конфигурации haproxy.
max_connections
Максимальное количество одновременных подключений, поддерживаемых предложением сети.
name
обязательно
Имя предложения сети.
network_rate
Скорость передачи данных в мегабитах в секунду.
persistent
True, если предложение сети поддерживает персистентные сети.
По умолчанию false, если не указано.
service_capabilities
Желаемые возможности услуг как часть предложения сети.

Псевдонимы: service_capability
service_offering
Имя или ID предложения услуг, используемого поставщиком виртуальных маршрутизаторов.
service_provider
Сопоставление поставщика услуг.
Если не указано, поставщик услуг будет сопоставлен с поставщиком по умолчанию на физической сети.

Псевдонимы: service_provider
specify_ip_ranges
bool
    Варианты:
  • no
  • yes
Поддерживает ли предложение сети указание диапазонов IP-адресов.
По умолчанию no API, если не указано.
specify_vlan
bool
    Варианты:
  • no
  • yes
Поддерживает ли предложение сети VLAN или нет.
state
    Варианты:
  • enabled
  • present ←
  • disabled
  • absent
Состояние предложения сети.
supported_services
    Варианты:
  • Dns
  • PortForwarding
  • Dhcp
  • SourceNat
  • UserData
  • Firewall
  • StaticNat
  • Vpn
  • Lb
Услуги, поддерживаемые предложением сети.
Один или несколько из выбранных вариантов.

Псевдонимы: supported_service
traffic_type По умолчанию:
"Guest"
Тип трафика для предложения сети.

Примечания

Примечание

  • Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация читается из нескольких источников в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. CLOUDSTACK_TIMEOUT переменные среды. CLOUDSTACK_CONFIG переменная среды, указывающая на файл .ini. Файл cloudstack.ini в текущем рабочем каталоге. Файл .cloudstack.ini в домашнем каталоге пользователя. При необходимости можно указать несколько учетных данных и конечных точек, используя разделы ini в cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию раздел cloudstack. Дополнительную информацию см. на странице https://github.com/exoscale/cs.
  • Подробное руководство по модулям Cloudstack можно найти в Руководстве по облаку CloudStack.
  • Этот модуль поддерживает режим проверки.

Примеры

- name: Create a network offering and enable it
  local_action:
    module: 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 ]
    service_providers:
      - { service: 'dns', provider: 'virtualrouter' }
      - { service: 'dhcp', provider: 'virtualrouter' }


- name: Remove a network offering
  local_action:
    module: cs_network_offering
    name: my_network_offering
    state: absent

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

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

Ключ Возвращаемое значение Описание
availability
строка
 успех
Доступность сетевого предложения.

Пример:
Необязательно
display_text
строка
 успех
Текст для отображения сетевого предложения.

Пример:
Моё сетевое предложение
egress_default_policy
строка
 успех
Политика по умолчанию для исходящего трафика.

Пример:
разрешить
guest_ip_type
строка
 успех
Тип гостевого сетевого предложения.

Пример:
Изолированный
id
строка
 успех
UUID сетевого предложения.

Пример:
a6f7a5fc-43f8-11e5-a151-feff819cdc9f
is_default
логическое значение
 успех
Является ли сетевое предложение предложением по умолчанию.
is_persistent
логическое значение
 успех
Поддерживаются ли постоянные сети.
max_connections
целое число
 успех
Максимальное количество одновременных подключений, обрабатываемых балансировщиком нагрузки.

Пример:
300
name
строка
 успех
Название сетевого предложения.

Пример:
MyCustomNetworkOffering
network_rate
целое число
 успех
Скорость передачи сетевого трафика в Мбит/с.

Пример:
200
service_offering_id
строка
 успех
Идентификатор предложения сервиса.

Пример:
c5f7a5fc-43f8-11e5-a151-feff819cdc9f
state
строка
 успех
Состояние сетевого предложения.

Пример:
Включено
traffic_type
строка
 успех
Тип трафика.

Пример:
Гостевой


Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

  • Давид Пассанте (@dpassante)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/cs_network_offering_module.html

Spec-Zone.ru

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