Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Быстрый старт

В этом быстром старте описаны шаги, которые помогут начать работу с Cloudlink. Вы узнаете, как подключить облако, создать новую организацию и информационное окружение, пополнить счет организации и выполнить первый заказ ресурса.

Перед выполнением шагов быстрого старта установите дистрибутив Cloudlink. Подробнее — в инструкции Установка и обновление.

1. Шаг. Создание нового подключения

Для подключения нового облака:

  1. Авторизуйтесь в Control Panel.

  2. Перейдите в раздел Инфраструктура → Подключение.

  3. Нажмите Добавить и выберите нужное подключение:

    create new cloud setup

    1. Для подключения zVirt заполните обязательные поля:

      • На шаге Соединение:

        • Адрес подключения — введите URL-адрес для подключения к платформе, например https://engine.example.ru.

          Вместо engine.example.ru укажите FQDN (Fully Qualified Domain Name) вашего сервера zVirt Engine. Используйте только доменное имя, доступное в вашей инфраструктуре, без IP-адресов.

        • Логин — укажите имя пользователя в зависимости от конфигурации системы:

          • Используйте формат example_user@internal, если Keycloak не установлен, где example_user — имя администратора в zVirt.

          • Используйте формат example_user@internalsso, если Keycloak установлен, где example_user — имя администратора в zVirt.

        • Пароль — введите пароль администратора.

        • Включить SSL-верификацию — по умолчанию SSL-верификация данных активирована. Если верификация не требуется, нажмите на галочку для деактивации.

          infra cloud add connection 2

      • На следующих шагах введите:

        • Имя нового подключения — уникальное название подключения, используя только латинские буквы, дефис -, точки и нижнее подчеркивание _.

        • Установите таймауты подключения.

      • Нажмите Готово, чтобы запустить создание подключения.

    2. Для подключения vSphere заполните обязательные поля:

      • На шаге Соединение:

        • Адрес подключения — введите URL-адрес для подключения к платформе, например https://vsphere.example.ru.

        • Логин — укажите имя пользователя в зависимости от конфигурации системы.

      • Пароль — введите пароль администратора.

        • Включить SSL-верификацию — по умолчанию SSL-верификация данных активирована. Если верификация не требуется, нажмите на галочку для деактивации.

      • На следующих шагах введите:

        • Имя нового подключения — уникальное название подключения, используя только латинские буквы, дефис -, точки и нижнее подчеркивание _.

        • Установите таймауты подключения.

      • Нажмите Готово, чтобы запустить создание подключения.

Подробнее о подключении нового облака — в Руководстве администратора Control Panel Cloudlink.

2. Шаг. Создание новой организации

В интерфейсе Control Panel:

  1. Перейдите в раздел Доступ → Организации.

  2. Нажмите Создать.

  3. Введите параметры:

    • Название — название вашей организации.

    • Email владельца — email-адрес владельца организации.

    • (Опционально) Описание — кратко опишите организацию.

    • Тарифные планы — выберите ранее созданный тарифный план.

    • DNS-серверы — укажите адрес DNS-сервера или серверов через запятую.

  4. Нажмите Далее.

    access control organization create 1

  5. Настройте Бюджет организации:

    • Чтобы создать организацию без назначения бюджета, нажмите Далее без бюджета.

    • Чтобы задать бюджет:

      • Укажите сумму в рублях (допускается только положительное число).

      • (Опционально) Включите параметр Отправлять уведомление Администратору, чтобы получать уведомления при превышении заданного порога использования бюджета.

        После включения параметра укажите процент от 1 до 100, при достижении которого будет отправлено уведомление администратору Портала.

        Подробнее — в инструкции об Уведомлениях о бюджете.

  6. Нажмите Далее.

    access control organization create 2

  7. Настройте Квоты организации:

    • Чтобы создать организацию без ресурсных квот, нажмите Далее без квот. Вы можете задать квоты после создания организации.

    • Чтобы задать квоты для организации:

      • Выберите платформу для подключения из списка.

      • Активируйте поля для квот по CPU, RAM, Диск и RAM(GPU) и задайте значения для них.

        access control organization create 3

  8. Нажмите Далее.

  9. Проверьте параметры и нажмите Создать организацию.

    access control organization create 4

После завершения настройки организация будет создана с указанными параметрами и станет доступна для дальнейшей работы.

Подробнее о создании организации и ее дополнительных настройках — в инструкции Настройка организации с нуля.

3. Шаг. Создание окружения

Для создания нового окружения:

  1. Перейдите в сервис Portal Manager по адресу https://portal-manager.sample.box/admin, где portal-manager — имя хоста (конкретный сервер или сервис), sample.box — домен (в этом примере тестовый), а /admin — путь, ведущий в административный раздел сервиса.

  2. В верхнем меню выберите вкладку Среда.

  3. Нажмите Создать Среда.

    guide organization create env 1

  4. Заполните поля:

    • Тип — выберите тип среды из значений по умолчанию: TEST, DEV или PROD.

    • Название — укажите название заглавными латинскими буквами.

    • Назначение среды — укажите назначение среды (произвольное описание).

    • Организация — в выпадающем списке выберите название созданной организации.

  5. Нажмите Создать.

    guide organization create env 2

4. Шаг. Создание информационной системы

Информационная система закрепляется за конкретной папкой организации. При создании папки в соответствующем проекте автоматически выбирается среда, привязанная к указанной информационной системе.

Чтобы создать информационную систему:

  1. Перейдите в сервис Portal Manager по адресу https://portal-manager.sample.box/admin, где portal-manager — имя хоста (конкретный сервер или сервис), sample.box — домен (в этом примере тестовый), а /admin — путь, ведущий в административный раздел сервиса.

  2. В верхнем меню выберите вкладку Информационные системы.

  3. Нажмите Создать Информационная система.

    guide organization info sys 1

  4. В разделе Создать Информационная система заполните обязательные поля:

    • Название — укажите название информационной системы.

    • Код ИС — укажите 4 латинские строчные буквы.

      Длина и регистр зафиксированы: значение поля — 4 строчные буквы.

    • Приоритет — по умолчанию 2.

    • Организация — выберите созданную ранее организацию.

    • Окружения организации — на данном этапе в списке отсутствуют значения.

  5. Нажмите Создать.

Окружение организации нужно указать после создания информационной системы.

5. Шаг. Привязка окружения к информационной системе

  1. В сервисе Portal Manager откройте вкладку Информационные системы.

  2. Нажмите на название созданной информационной системы.

    Вы перейдете на страницу подробностей.

  3. Нажмите Изменить Информационная система.

  4. В поле Окружения организации выберите созданную ранее среду.

  5. Нажмите Обновить.

К информационной системе может быть привязано несколько сред. Чтобы добавить новую среду — повторите действия, аналогичные добавлению первой.

6. Шаг. Назначение информационной системы папке

  1. Войдите в пользовательский Портал Cloudlink.

  2. Перейдите в раздел Управление доступом → Организация.

  3. Нажмите на название папки или организации.

  4. В открывшемся окне справа перейдите на вкладку Информационные системы.

  5. Выберите действие Назначить систему и выберите одну или несколько информационных систем.

  6. Нажмите Готово.

7. Шаг. Создание папки проекта с собственным счетом

  1. Войдите в пользовательский Портал Cloudlink.

  2. Перейдите в раздел Управление доступом.

  3. Нажмите на организацию и разверните контекстное меню, нажмите на иконку ⋮.

  4. Выберите действие Создать папку.

    organization access management

  5. Заполните название, информационные системы, установите галочку Создать собственный счет.

    organization access management 2

  6. Подтвердите создание папки, нажав Создать.

8. Шаг. Перевод денег между счетами организации

  1. В пользовательском Портале перейдите в раздел Управление доступом → Организация.

  2. Нажмите на иконку ⋮ напротив папки или организации, из которой вы будете переводить средства.

  3. В списке выберите пункт Перевести.

  4. В открывшемся окне заполните поля:

    • Получатель — выберите организацию или папку, в которую нужно отправить средства.

    • Сумма — введите сумму для перевода.

    • (Опционально) Комментарий

  5. Нажмите Перевод средств.

organization money transfer

Для просмотра истории переводов средств нажмите ⋮ напротив необходимой папки и выберите — История переводов.

9. Шаг. Пополнение счета организации

Для выполнения перевода на счете отправителя должен быть положительный баланс. При недостатке средств операция будет отклонена.
funds transfer overview

Кнопка b funds transfer Перевод средств отображается в верхнем правом углу Control Panel и доступна на всех страницах.

  1. Войдите в Control Panel.

  2. В правом верхнем углу интерфейса нажмите b funds transfer Перевод средств.

  3. Выберите вкладку Перевод и укажите следующие параметры:

    1. Откуда переводим — выберите счет отправителя.

    2. Куда переводим — выберите организацию, которая получит денежные средства.

    3. Сумма — укажите сумму перевода.

    4. Комментарий — при необходимости укажите описание.

  4. Нажмите Перевести.

    funds transfer create transfer

    После отправки запроса отображается индикатор выполнения операции «Переводим средства».

    При успешном переводе отобразится информация:

    • счет отправителя и остаток после операции;

    • счет получателя и остаток после операции

  5. Для завершения нажмите Готово.

funds transfer finish

Баланс счетов обновляется автоматически после перевода.

Подробнее — в инструкции о переводе средств и просмотре истории переводов.

10. Шаг. Создание ресурсного пула

  1. Войдите в Control Panel.

  2. Перейдите в раздел Конструктор → Справочники.

  3. Выберите необходимый справочник, например "Resource_pool".

  4. На вкладке Страницы нажмите Добавить страницу. Например, в справочнике "Resource_pool" новая страница будет описывать параметры для добавления новой платформы в систему.

    В открывшемся окне укажите следующие параметры:

    1. Имя — название кластера из системы виртуализации.

    2. Степень важности — определяет приоритет использования для размещения ресурсов.

    3. PageData — содержит описание платформы в формате JSON, со следующей структурой:

      • resource_pool — описывает пул ресурсов для создания платформы:

        • name — имя кластера хранения из системы виртуализации.

        • uuid — идентификатор кластера хранения.

        • domain — имя домена хранения, который будет доступен для заказа ресурсов в системе Cloudlink.

        • endpoint — FQDN системы виртуализации.

      • platform — описывает тип платформы, обычно в зависимости от используемой системы виртуализации.

      • category — описывает категорию использования. Например значение vm - указывает, что платформа используется для размещения виртуальных машин.

        Пример 1. Заполнение PageData для zVirt
        {
"data": {
    "resource_pool": {
        "name": "Default",
        "uuid": "fa859514-d410-11ef-8e09-00163e0091a7",
        "domain": "vm-data-1",
        "endpoint": "https://engine.orionsoft.local:443/ovirt-engine",
        "platform": "zvirt",
        "provider_name": "zvirt"
        }
    },

    "category": "vm",
    "platform": "zvirt"
}
        Пример 2. Заполнение PageData для vSphere
        {
"data": {
   "resource_pool": {
        "name": "CL01",
        "uuid": "domain-c1001",
        "ui_link": "https://vcenter.orionsoft.local:443",
        "endpoint": "https://vcenter.orionsoft.local:443",
        "platform": "vsphere",
        "data_store": "datastore-11",
        "provider_name": "vsphere",
        "tenant_prefix": "cloudlink"
        }
    },

    "category": "vm",
    "platform": "vsphere"
}

    4. Теги — укажите теги, которые используются как Код при дальнейшем создании платформы.

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

11. Шаг. Создание дата-центра

Чтобы создать дата-центр:

  1. В Control Panel перейдите в раздел Инфраструктура → Дата-центры.

  2. Нажмите Создать дата-центр.

    organization create dc 1

  3. В окне Создать дата-центр:

    1. Заполните поля:

      • Код — укажите код дата-центра.

      • Обозначение латиницей — укажите обозначение дата-центра (может совпадать с кодом).

        Значения полей Kод и Обозначение латиницей — произвольные.

      • Организация — выберите созданную ранее организацию.

      • (Опционально) Вес — выберите значение. Вес определяет приоритет созданной сущности в списке: чем значение меньше, тем выше приоритет.

      • (Опционально) Сегменты сети — на этом этапе не задаются.

    2. Включите опцию Доступен на форме заказа.

    3. Нажмите Создать.

      organization create dc 2
Если сегмент сети создается раньше, чем дата-центр, его можно будет выбрать в поле Сегменты сети.

12. Шаг. Создание сегмента сети

Чтобы создать сегмент сети:

  1. В Control Panel Cloudlink перейдите в раздел Инфраструктура → Сегменты сети и нажмите Создать сегмент сети.

  2. В окне Создать сегмент сети:

    1. Заполните поля:

      • Название — укажите название сегмента сети.

      • Код — укажите код сегмента сети (может совпадать с названием).

      • Организация — выберите созданную ранее организацию.

      • (Опционально) Вес — выберите значение. Вес определяет приоритет созданной сущности в списке: чем значение меньше, тем выше приоритет.

      • Дата-центры — выберите созданный ранее дата-центр.

      • Среды — выберите одну или несколько созданных ранее сред.

      • (Опционально) Домены — оставьте поле пустым.

        guide organization create nets

    2. Нажмите Создать.

13. Шаг. Подключение сегмента сети к дата-центру

Чтобы проверить привязку сегмента сети к дата-центру:

  1. Перейдите в Инфраструктура → Дата-центры.

  2. Напротив нужного дата-центра нажмите ⋮ и выберите Редактировать.

  3. Убедитесь, что в поле Сегменты сети указан созданный сегмент сети.

14. Шаг. Создание платформы

Чтобы создать платформу:

  1. В Control Panel Cloudlink перейдите в раздел Инфраструктура → Платформы.

  2. Нажмите Создать платформу.

    1. Заполните поля:

      • Название — укажите название платформы.

      • Код — укажите код платформы (может совпадать с названием).

        Значение поля Код должно совпадать с уникальным тегом Ресурсного пула.

      • Организация — выберите созданную ранее организацию.

      • (Опционально) Вес — выберите значение. Вес определяет приоритет созданной сущности в списке: чем значение меньше, тем выше приоритет.

    2. Нажмите Создать.

Чтобы добавить сегменты сети и дата-центры к платформе:

  1. Нажмите ⋮ напротив созданной платформы и выберите Редактировать.

    1. В поле Сегменты сети выберите созданный ранее сегмент сети.

    2. В поле Дата-центры выберите созданный ранее дата-центр.

    3. Нажмите Сохранить.

15. Шаг. Настройка сети в NetBox

Чтобы виртуальные машины стали доступны для заказов, настройте сеть в сервисе NetBox, расположенном по адресу "https://netbox.sample.box", где sample.box — это пример доменного имени, которое нужно заменить на реальный доменный адрес.

Для входа в NetBox используйте авторизацию через Keycloak, нажмите кнопку Keycloak на странице входа.

netbox auth

15.1. Создать площадку (дата-центр)

  1. Перейдите в раздел Организация → Площадки.

  2. Нажмите + Добавить и заполните поля:

    netbox sites overview

    • Имя — название площадки, которое должно совпадать с кодом дата-центра.

    • Подстрока — совпадает с кодом дата-центра.

  3. Нажмите Создать.

    netbox sites add

15.2. Создать сегмент сети

  1. Перейдите в раздел IPAM → VLAN-ы.

  2. Нажмите + Добавить и заполните поля:

    • VLAN ID — укажите произвольное значение.

    • Имя — название VLAN должно совпадать с кодом сегмента сети.

    • В блоке Задание выберите вкладку Площадка:

    • В блоке Настраиваемые поля в поле Custom virt subnet uuid укажите идентификатор профиля vNIC.

  3. Нажмите Создать.

    netbox vlans 1
    netbox vlans 2

    Получение идентификатора профиля vNIC:

    • Для zVirt:

      На портале администрирования zVirt перейдите в раздел меню Сеть → Профили vNIC и скопируйте ID.

      netbox id zvirt

    • Для vSphere:

      В интерфейсе vSphere Client перейдите на вкладку Networks и нажмите на название нужной группы портов (PortGroup). после этого в строке URL скопируйте uuid PortGroup (общий вид uuid — dvportgroup-1111).

      netbox id vsphere
Пример создания VLAN для Zvirt 
VLAN ID = 2302
# Имя ресурса vNIC Profile
Имя = test_vlan2302
Статус = Активный
Арендатор = BOX
Площадка = Test-site
# Идентификатор vNIC Profile, который можно получить запросом к api (значение "id" нужной сети)
Custom virt subnet uuid = 00000000a-000a-000a-00000000398
Пример создания VLAN для vSphere 
ID = 1
# Имя ресурса DistributedVirtualPortgroup
Name = DPortGroup
Status = Active
Tenant = BOX
Site = COD-A
# Идентификатор ресурса DistributedVirtualPortgroup, например:
# urn:urn:vmomi:DistributedVirtualPortgroup:dvportgroup-3027:a6ba13a8-a1a8-4e9f-963a-7418f86ff77c/summary
Custom virt subnet uuid = dvportgroup-3027

15.3. Создать таблицу маршрутизации

  1. Перейдите в раздел IPAM → VRFs.

  2. Нажмите + Добавить и заполните поля:

    • Имя — совпадает с кодом сегмента сети.

    • RD — совпадает с кодом сегмента сети.

  3. Нажмите Создать.

15.4. Создать подсеть

  1. Перейдите в раздел IPAM → Префиксы.

  2. Нажмите + Добавить и заполните поля:

  3. Нажмите Создать.

    netbox prefix 1
    netbox prefix 2

15.5. Создать диапазон запрещенных IP-адресов

При необходимости можно исключить отдельные IP-адреса из выдачи, создав диапазон IP-адресов (IP Range). Таким образом исключается IP-адрес шлюза, так как он используется как шлюз по умолчанию (default gateway) и не должен выдаваться виртуальным машинам. Его исключение предотвращает IP-конфликты и проблемы с маршрутизацией в подсети.

Чтобы запретить выдачу IP-адреса шлюза:

  1. Перейдите в раздел IPAM → IP-адреса.

  2. Нажмите + Добавить и заполните поля:

  3. Нажмите Создать.

    netbox ip address

Чтобы создать диапазон запрещенных IP-адресов:

  1. Перейдите в раздел IPAM → Диапазоны IP-адресов.

  2. Нажмите + Добавить и заполните поля:

    • VRF — выберите ранее созданный домен маршрутизации (VRF), к которому будет относиться диапазон.

    • Начальный адрес — укажите начальный IP-адрес диапазона с маской (сокращённый вид маски /24). Например, 10.248.7.1/24.

    • Конечный адрес — укажите конечный IP-адрес диапазона (с маской). Например, 10.248.7.99

      В примере задан диапазон адресов с 1 по 99, поэтому первым доступным адресом для выдачи станет 10.248.7.100/24.

    • Статус — установите значение Зарезервировано.

    • Активируйте опцию Отметка заполнена (Mark populated), чтобы запретить создание IP-адресов внутри данного диапазона.

    • Активируйте опцию Использованная марка (Mark utilized), чтобы отметить диапазон IP-адресов как полностью занятый.

      Обязательно активируйте опцию Использованная марка (Mark utilized), иначе диапазон будет считаться доступным и его IP-адреса, включая адрес шлюза, могут быть назначены виртуальным машинам.

  3. Нажмите Создать.

    netbox ip range add

16. Шаг. Работа с Порталом Cloudlink

16.1. Создать личный SSH-ключ

В пользовательском Портале Cloudlink можно управлять SSH-ключами, используемыми для доступа к виртуальным машинам. В системе поддерживаются два типа ключей: личные и проектные. Под личным понимается SSH-ключ, привязанный к вашей учетной записи и предназначенный для персонального доступа. Такой ключ создается и хранится в профиле пользователя, а не в рамках конкретного проекта.

  1. Авторизуйтесь в пользовательском Портале Cloudlink.

  2. Смените контекст на проект нужной организации.

  3. Перейдите в раздел Управление доступом → SSH ключи.

  4. Нажмите Добавить и заполните параметры:

    1. Выберите тип ключа Личный.

    2. В поле Название введите название добавляемого ключа.

    3. В поле Логин введите имя пользователя, для которого добавляется ключ.

      organization access management ssh key

    4. Сгенерируйте пару ключей на клиентской машине:

      1. Откройте терминал и выполните команду:

        $ ssh-keygen -t rsa

        Если команда ssh-keygen не найдена, установите пакет OpenSSH.

      2. Укажите путь до файла, в который нужно сохранить SSH-ключ или оставьте по умолчанию и нажмите Enter.

      3. Введите кодовую фразу (если фраза введена, она будет запрашиваться при обращении на сервер) или оставьте строку пустой и нажмите Enter.

        В папке .ssh (по умолчанию) будут созданы два файла: id_rsa (приватный ключ) и id_rsa.pub (публичный ключ). В терминале отобразится отпечаток сгенерированного ключа.

      4. В терминале введите команду для отображения публичного ключа:

        $ cat ~/.ssh/id_rsa.pub

      5. Скопируйте значение ключа и вставьте в поле ключа в окно Добавление SSH-ключ на Портале.

        Подробнее о генерации SSH-ключей в Руководстве пользователя — SSH-ключи.

  5. Подтвердите добавление, нажав Добавить.

16.2. Запустить заказ и проверить предбиллинг

  1. На пользовательском Портале Cloudlink выберите нужную организацию, проект или папку.

  2. Перейдите в раздел Заказы и нажмите Добавить ресурс.

    portal orders new order

  3. Выберите ресурс и заполните обязательные параметры.

    Подробнее о создании заказа в Руководстве пользователя — Заказы.

  4. Дождитесь расчета предбиллинга по этому ресурсу.

  5. Подтвердите заказ кнопкой Заказать.

  6. Для просмотра созданного ресурса в общем списке нажмите на кнопку Перейти к ресурсам.

create astra vm

16.3. Проверить мониторинг ВМ

  1. На пользовательском Портале Cloudlink выберите нужную организацию, проект или папку.

  2. Перейдите в раздел Мониторинг → Метрики ВМ.

  3. Выберите операционную систему:

    • Linux — подробнее о метриках для виртуальных машин на базе Linux.

    • Windows — подробнее о метриках для виртуальных машин на ОС Windows.

      Набор дашбордов в мониторинге зависит от выбора операционной системы. Для ОС Windows и Linux этот набор отличается и учитывает особенности систем.

  4. Выберите название виртуальной машины (хостнейм), для которой нужно отобразить данные мониторинга.

  5. Укажите промежуток времени, за который требуется отобразить метрики.

  6. Нажмите Применить.

portal monitoring main