Spec-Zone.ru › Ansible 2.10

ngine_io.cloudstack.cs_vlan_ip_range – Управляет диапазонами IP-адресов VLAN в облаках на основе Apache CloudStack.

Примечание

Этот плагин является частью коллекции ngine_io.cloudstack (версия 1.1.0).

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

Чтобы использовать его в книге задач, укажите: ngine_io.cloudstack.cs_vlan_ip_range.

Новое в версии 0.1.0: модуля ngine_io.cloudstack

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

Описание

  • Создание и удаление диапазона IP-адресов VLAN.

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
account
строка
Аккаунт, владеющий VLAN.
Взаимоисключающие с параметром project.
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, см. также примечания.
api_verify_ssl_cert
строка
Файл сертификата CA.
Если не указан, рассматривается переменная среды CLOUDSTACK_VERIFY.
В качестве последнего варианта, значение берется из файла конфигурации ini, см. также примечания.
Значение по умолчанию null, если не указано.
cidr_ipv6
строка
CIDR IPv6-сети, должен быть не менее /64.
domain
строка
Домен аккаунта, владеющего VLAN.
end_ip
строка
Конечный IPv4-адрес в диапазоне IP VLAN.
Если не указан, используется значение start_ip.
Рассматривается только при создании.
end_ipv6
строка
Конечный IPv6-адрес в диапазоне IPv6-сети.
Если не указан, используется значение start_ipv6.
Рассматривается только при создании.
for_system_vms
логическое значение
    Варианты:
  • нет ←
  • да
yes если диапазон IP назначен системам VM, no если нет.
for_virtual_network
логическое значение
добавлен в версии 1.0.0 ngine_io.cloudstack
    Варианты:
  • нет ←
  • да
yes если VLAN виртуального типа, no если прямой.
Если установлено yes, но ни physical_network, ни network не установлены, CloudStack попытается добавить диапазон VLAN в физическую сеть с типом трафика «Общедоступный».
gateway
строка
Шлюз диапазона IP VLAN.
Требуется, если state=present.
gateway_ipv6
строка
Шлюз IPv6-сети.
Рассматривается только при создании.
netmask
строка
Маска подсети диапазона IP VLAN.
Требуется, если state=present.
network
строка
Имя или идентификатор сети.
Требуется, если for_virtual_network и physical_network не установлены.
physical_network
строка
Имя или идентификатор физической сети.
pod
строка
добавлен в версии 1.0.0 ngine_io.cloudstack
Имя подсети.
project
строка
Проект, владеющий VLAN.
Взаимоисключающие с параметром account.
start_ip
строка / обязательный
Начальный IPv4-адрес в диапазоне IP VLAN.
Рассматривается только при создании.
start_ipv6
строка
Начальный IPv6-адрес в диапазоне IPv6-сети.
Рассматривается только при создании.
state
строка
    Варианты:
  • present ←
  • absent
Состояние диапазона IP-адресов сети.
vlan
строка
Идентификатор или VID сети.
Если не указан, по умолчанию используется VLAN сети.
zone
строка
Идентификатор зоны диапазона IP VLAN.
Если не задан, используется зона по умолчанию.

Примечания

Примечание

  • 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 VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    network: test
    vlan: 98
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    gateway: 10.2.4.1
    netmask: 255.255.255.0
    zone: zone-02

- name: remove a VLAN IP range for network test
  ngine_io.cloudstack.cs_vlan_ip_range:
    state: absent
    network: test
    start_ip: 10.2.4.10
    end_ip: 10.2.4.100
    zone: zone-02

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

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

Ключ Возвращаемое значение Описание
account
string
если доступно
Аккаунт, владеющий сетью.

Пример:
примерный аккаунт
cidr_ipv6
string
если доступно
CIDR IPv6 сети.

Пример:
2001:db8::/64
domain
string
успех
Имя домена диапазона IP-адресов VLAN.

Пример:
ROOT
end_ip
string
успех
Конечный IP-адрес диапазона IP-адресов VLAN.

Пример:
10.2.4.100
end_ipv6
string
если доступно
Конечный IPv6-адрес диапазона IP-адресов VLAN.

Пример:
2001:db8::50
for_systemvms
boolean
успех
Принадлежит ли диапазон IP-адресов VLAN виртуальным машинам системы.
for_virtual_network
boolean
успех
Является ли диапазон IP-адресов VLAN виртуального типа.
gateway
string
успех
IPv4 шлюз.

Пример:
10.2.4.1
gateway_ipv6
string
если доступно
IPv6 шлюз.

Пример:
2001:db8::1
id
string
успех
UUID диапазона IP-адресов VLAN.

Пример:
04589590-ac63-4ffc-93f5-b698b8ac38b6
netmask
string
успех
IPv4 маска сети.

Пример:
255.255.255.0
network
string
если доступно
Сеть диапазона vlan.

Пример:
test
physical_network
string
успех
Физическая сеть, к которой принадлежит диапазон IP-адресов VLAN.

Пример:
04589590-ac63-4ffc-93f5-b698b8ac38b6
project
string
если доступно
Проект, владеющий сетью.

Пример:
примерный проект
start_ip
string
успех
Начальный IP-адрес диапазона IP-адресов VLAN.

Пример:
10.2.4.10
start_ipv6
string
если доступно
Начальный IPv6-адрес диапазона IP-адресов VLAN.

Пример:
2001:db8::10
vlan
string
успех
Идентификатор или VID VLAN.

Пример:
vlan://98
zone
string
успех
Название зоны.

Пример:
zone-02


Авторы

  • David Passante (@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.10/collections/ngine_io/cloudstack/cs_vlan_ip_range_module.html

Spec-Zone.ru

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