Для улучшения работы сайта мы используем файлы 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. Нажмите Далее, чтобы заполнить параметры на странице Ресурсные квоты:

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

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

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

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

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

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

create new organization

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

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. Шаг. Пополнение счета организации

Для пополнения счета конкретной организации:

  1. Перейдите в раздел Биллинг → Пополнение счета.

  2. Выберите организацию, счет которой необходимо пополнить.

  3. Выберите из списка Счет отправитель и Счет получатель.

  4. Укажите сумму перевода.

  5. Введите описание перевода.

  6. Нажмите Подтвердить.

billing account deposit

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 (adminUsername и adminPassword) можно получить в сервисе StarVault по адресу "https://starvault.sample.box/ui/vault/secrets/deployment/show/netbox", где starvault — имя хоста, sample.box — пример доменного имени (замените на фактический), /ui/vault/secrets/deployment/show/netbox — путь к секрету).

15.1. Создать сайт

  1. Перейдите в раздел Organization → Sites и нажмите +Add.

  2. В разделе Add a new site:

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

      • Name — уникальное название дата-центра.

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

    2. Нажмите Create.

15.2. Создать VLAN

  1. Перейдите в раздел IPAM → VLANs и нажмите +Add.

  2. В разделе Add a new VLAN:

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

      • ID — произвольное значение.

      • Name — уникальное название VLAN.

  3. Перейдите в раздел Assignment → Site в поле Site и выберите имя созданного ранее сайта (дата-центра) из выпадающего списка.

  4. В Custom Fields в поле Custom virt subnet uuid укажите идентификатор виртуальной подсети.

  5. Нажмите Create.

    Способ получения ID для разных платформ:

    • Для платформы zVirt:

      1. Перейдите в веб-интерфейс zVirt.

        1. Зайдите на вкладку Сети → Профили vNIC.

        2. Скопируйте ID виртуальной подсети.

    • Для платформы vSphere:

      1. Перейдите в веб-интерфейс vSphere Client.

        1. Перейдите в раздел Hosts and Clusters.

        2. Нажмите по необходимому кластеру и скопируйте из URL значение параметра ClusterComputeResource.

          vmware 1

    • Для платформы OpenStack:

      1. Авторизуйтесь на платформе OpenStack.

      2. В интерфейсе платформы выберите раздел Compute → Instances.

        1. Нажмите на название нужной виртуальной машины. Вы попадете на страницу подробной информации о ВМ.

        2. Скопируйте значение из строки ID.

          openstack id

15.3. Создать VRF

  1. Перейдите в раздел IPAM → VRFs и нажмите +Add.

  2. В разделе Add a new VRF:

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

      • Name —  уникальное название VRF.

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

    2. Нажмите Create.

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

  1. Перейдите в раздел IPAM → Prefixes и нажмите +Add.

  2. В разделе Add a new prefix заполните поля:

    • Prefix — укажите префикс виртуальной подсети.

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

    • Tags — в выпадающем списке выберите теги cloud, zvirt и идентификатор кластера, которому будет доступна созданная подсеть.

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

      • VLAN — в выпадающем списке выберите имя созданной ранее виртуальной локальной сети.

      • Default gw — укажите IP-адрес шлюза по умолчанию для создаваемых виртуальных машин.

      • Nameservers — укажите список DNS-серверов в формате JSON, например: ["8.8.8.8", "1.1.1.1"].

  3. Нажмите Create.

При необходимости можно запретить использование каких-либо IP-адресов.

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

  1. Перейдите в раздел IPAM → IP Ranges и нажмите +Add.

  2. В разделе Add a new IP range:

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

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

      • Start address — укажите начальный IP-адрес диапазона запрещенных к использованию IP-адресов.

      • End address — укажите конечный IP-адрес диапазона запрещенных к использованию IP-адресов.

    2. Нажмите Create.

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