Модуль VMware vCloud Director (VDS)

Материал из ISPWiki
Перейти к: навигация, поиск


Общие сведения

Модуль интеграции VMware vCloud Director (VDS) разработан для предоставления услуги - виртуальный выделенный сервер (VDS).

Интеграция поддерживается с vCloud Director версий 5.6[1] - 8.X.

Основные возможности модуля:

  • Создание виртуальных выделенных серверов
  • Изменение параметров виртуальных выделенных серверов

Создание виртуального сервера

При заказе виртуального выделенного сервера определяются такие параметры, как - дисковое пространство, оперативная память, количество процессоров и количество IP-адресов:

Vmware-vds1.png

Алгоритм создания виртуальной машины:

  • Проверяется наличие учетной записи клиента на стороне vCloud Director. Если клиент еще не имеет учетной записи, то BILLmanager создает в vCloud Director пользователя с именем user(email@example.com) и правами, указанными в настройках обработчика услуги (по умолчанию vApp User).
  • Проверяется наличие vApp у пользователя.
    • Если у пользователя нет vApp, то он будет создан с именем "vapp-email@example.com_1", где email@example.com - email пользователя, а _1 номер vApp данного пользователя.
    • Если у пользователя есть vApp, то проверяется количество созданных в нем виртуальных машин. Если их количество превышает 128 шт. (Подробности по ссылке), создается новый vApp с номеров 2, 3 и т.д.
  • В vApp создается виртуальная машина:
    • Производится поиск сети с наибольшим количеством свободных IP (перебираются все сети с префиксом, указанным в настройках обработчика). Обратите внимание, что интеграция осуществляется с правами администратора организации, в следствии чего данные по занятым IP возможно получить только для данной организации. Для услуги "Виртуальный сервер" мы рекомендует использовать внешние сети монопольно, дабы избежать ошибок при подсчете свободных IP для сетей организации;
    • Добавляется машина с параметрами, указанными в шаблоне vApp (nCPU, DISC, имя виртуальной машины);
    • Создается сеть уровня vApp и подключается к сети, найденной на этапе ранее;
    • Применяются параметры виртуальной машины, указанные при заказе услуги;
    • Производится рекастомизация виртуальной машины;
    • Виртуальная машина включается.

Владельцу виртуальной машины не предоставляется доступ в vCloud Director, однако имеется возможность перейти в web консоль vds с помощью кнопки «Web-консоль».

Изменение параметров виртуальной машины

Для существующей виртуальной машины можно изменить следующие параметры (если разрешено изменение по тарифному плану):

  • Пароль - можно менять пароль только для кастомизируемых шаблонов.
  • Количество виртуальных процессоров, количество оперативной памяти - параметры можно изменить как в меньшую, так и в большую сторону, изменения произойдут незамедлительно. Виртуальная машина будет перезагружена для применения новой конфигурации.
  • Объем жесткого диска - изменение размера жесткого диска возможно только в большую сторону. При изменении размера диска увеличивается только размер блочного устройства, увеличивать размер файловой системы необходимо вручную. Виртуальная машина будет перезагружена для применения новой конфигурации.
  • Публичные IPv4-адреса - при увеличении/уменьшении количества IP адресов для виртуальной машины изменения вступают в силу незамедлительно. VDS будет перезагружен для применения изменений.

Интеграция BILLmanager с vCloud Director

Настройка VMware vCloud

1. Необходимо создать организацию со следующими параметрами (На вкладке Policies):

Создание организации в VMware vCloud
  1. Maximum runtime lease: Never Expires;
  2. Maximum storage lease: Never Expires;
  3. Storage cleanup: Move to Expired Items;
  4. All VMs quota: Unlimited;
  5. Running VMs quota: Unlimited;
  6. Number of resource intensive operations per user: Unlimited;
  7. Number of resource intensive operations per organization: Unlimited;
  8. Number of simultaneous connections per VM: Unlimited;

2. В организации из п.1 создать пользователя с ролью: "Organization Administrator":

Создание пользователя в VMware vCloud
  1. Установить квоты для созданного пользователя:
    1. All VMs quota: Unlimited;
    2. Running VMs quota: Unlimited;

3. В организации из п.1 необходимо создать Виртуальный дата-центр с параметрами:

Создание виртуального дата-центра в VMware vCloud
  1. На вкладке "Allocation". Maximum numbers of VMs: Unlimited;
  2. На вкладке "Storage" установить галочку Enable thin provisioning;

4. К виртуальному дата-центру из п.3 необходимо подключить внешнюю сеть с "белыми" IP (из этой сети будут выдаваться адреса для создаваемых VDS)

5. Для заказа услуги VDS необходимо, чтобы в vCloud были доступны шаблоны vApp, отвечающие следующим требованиям:

  • Шаблон должен быть публичным;
  • Содержать в себе одну виртуальную машину;
  • В шаблоне должна быть включена Guest Customization;
  • В шаблоне vApp не должно быть подключенных сетей.

Настройка BILLmanager

Установка обработчика услуг

Интеграция с модулем возможна только в версии BILLmanager Corporate.

Перед установкой модуля, Вам необходимо приобрести лицензию на данный модуль в вашем Личном кабинете и привязать его к лицензии вашего BILLmanager 5.

Установка производится автоматически при создании обработчика из меню Обработчики услуг -> Создать -> Виртуальный сервер -> VMware vCloud Director (VDS)

Настройка обработчика услуг

Настройка интеграции BILLmanager 5 с VMware vCloud производится на форме Обработчики услуг -> Создать -> Виртуальный сервер -> VMware vCloud Director (VDS)

Настройка модуля обработки

Параметры обработчика (см. настройки vCloud):

  • URL - url для доступа к API vCloud. Например: https://vcloud.example.com/api;
  • Имя пользователя - имя администратора организации vCloud, под которым будет производится интеграция;
  • Пароль - пароль администратора организации vCloud;
  • Роль пользователя - роль, с которой будет создан пользователь внутри создаваемого ВДЦ (по умолчанию предполагается использование роли vApp User). Роль определяет какими правами будет обладать клиент;
  • Организация - организация в которой находится ВДЦ для размещения виртуальных машин;
  • Виртуальный дата-центр - ВДЦ для размещения виртуальных машин;
  • Префикс сети организации - префикс сети организации для подключения виртуальных машин.

Настройка тарифного плана

Общие правила создания тарифного плана описаны в документации.

Модуль интеграции поддерживает автоматическую работу со следующими дополнениями тарифного плана:

  • Количество IP адресов
  • Дисковое пространство
  • Количество процессоров
  • Процессор (частота)
  • Оперативная память

Шаблоны операционных систем BILLmanager получает автоматически от модуля обработки - подгружает все кастомизируемые шаблоны из публичного (public) каталога vCloud Director. Шаблоны операционных систем (кроме Windows) автоматически подключаются к тарифному плану, то есть после добавления нового шаблона в vCloud Director он будет доступен в BILLmanager при заказе услуги автоматически (примерно через 30 минут - раз в 30 минут обработчик обновляет информацию о шаблонах).

Все полученные от обработчика шаблоны операционных систем отображаются в разделе Типы продуктов -> Виртуальный сервер -> Параметры -> Операционная система -> Значения. С помощью кнопки Тарифы имеется возможность отключить/подключить конкретный шаблон к тому или иному тарифному плану вручную.

Настройка перепродажи

Для настройки перепродажи виртуальных машин из VMware vCloud необходимо воспользоваться документацией. После настройки необходимо произвести следующие настройки в меню Типы продуктов -> Виртуальный сервер -> Параметры:

  1. Выберите параметр "Доменное имя" и нажмите кнопку "Изменить";
    1. Если оказываются только услуги перепродажи услуг виртуальных серверов на базе VMware vCloud, то необходимо снять галочки с пунктов "Показывать при заказе" и "Показывать при открытии". Для выпадающих списков "Доступ на чтение" и "Доступ для изменения" установите значение "Супер пользователь". Cохранить настройки параметра
    2. Если оказываются услуги продажи виртуальных серверов на других платформах, необходимо выставить опцию "Разрешить настройку подключения к тарифам", сохранить настройки параметра и в подразделе "Тарифы" выбрать тарифные планы услуги виртуальных серверов на платформах отличных от VMware vCloud
  2. В открывшемся меню "Параметры услуг - Виртуальный сервер" нажмите кнопку "Создать";
  3. В поле "Наименование (ru)" укажите "Имя виртуальной машины";
  4. В поле "Внутреннее имя" укажите "vmname";
  5. Включите галочки для полей "Показывать при заказе", "Показывать при открытии" и "Обязательный параметр";
  6. В поле "Функция проверки" укажите "ASCII";
  7. Если оказываются услуги продажи виртуальных серверов на других платформах, необходимо выставить опцию "Разрешить настройку подключения к тарифам", сохранить настройки параметра и в подразделе "Тарифы" выбрать тарифные планы услуги виртуальных серверов на платформе VMware vCloud

Технические особенности

В силу архитектурных особенностей работы vCloud Director (он не может самостоятельно "отдавать" свободные IP-адреса из внешних сетей) все виртуальные сервера открываются последовательно. То есть, если единовременно заказано несколько серверов, то они будут создаваться не параллельно, а по очереди. Удаление нескольких VPS так же происходит последовательно. Это объясняется тем, что обработчик пытается "понять", является ли текущая ВМ последней ВМ в vApp, и если это так, то обработчик пытается удалить не ВМ внутри контейнера, а весь контейнер целиком, чтобы не захламлять "общий" ВДЦ.

Логирование

Модуль обработки vCloud Director имеет отдельный лог - /usr/local/mgr5/var/pmvmwarevds.log

Подробную информацию о ошибках в задачах vCloud Director можно видеть в логах обработчика в формате:

<Task ... operation="Stopped Virtual Application qwe1(58b81329-ea2a-4f94-b999-1c36923a0340)" operationName="vappUndeployPowerOff" status="running">

...

</Task>

Атрибуты:

  • operation - имя операции, отслеживаемой данной задачей.
  • status отражает состояние текущей задачи:
    • success - завершена успешно;
    • error - завершена неудачей;
    • canceled - отменена владельцем или администратором;
    • aborted - прервана администратором;
    • running - выполняется.

Дочерние узлы:

  • Error - предоставляет информацию об ошибке в случае, если задача завершилась неудачей;
  • Progress - показывает состояние задачи в процентах от 0 до 100.

Возможные ошибки

Общие ошибки

Ошибка Описание
auth_token не удалось получить токен авторизации (скорее всего неверно указан логин или пароль)
forbidden пользователь, под которым производится интеграция с vCloud, не имеет прав на вызываемую функцию
not_found объект, которому адресован запрос, не существует
bad_request самая часто возникающая ошибка. Говорит о неверно составленном запросе или невозможности его обработки

Примеры:

  • Кончились ресурсы в ВДЦ
  • Невозможность создания вирт. маршрутизатора с этим IP
  • Невозможно получить информацию о ролях пользователей (не хватает прав)
  • ...

Разбираться с такими проблемами нужно по факту их возникновения в логах

task_error Данная ошибка говорит о том, что запрос на выполнение операции завершился неудачей

Ошибки обработчика vCloud Director (VDS)

Ошибка Описание
create_vds ошибка возникает в случае, если:
  • Виртуальная машина не смогла развернуться из шаблона vApp
  • Уже развернутую виртуальную машину не удалось подключить к сети ВДЦ
gen_vappname обработчик не смог сгенерировать уникальное имя vApp
edit_vds ошибка говорит о том, что не удалось изменить параметры VDS
  1. В версии 5.6 существует ошибка в vCloud Director, которая влечет за особой проблемы с выделением ip адресов