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

Настройка организации с нуля

Получить демо orion arrow rt

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

Этапы настройки организации с нуля:

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

  2. Создание среды

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

  4. Создание дата-центра, сегмента сети для организации и платформы

  5. Создание страницы справочника

  6. Обновление управляющего хоста

  7. Настройка структуры организации

  8. Настройка сети для виртуальных машин

Этапы взаимосвязаны, поэтому рекомендуется соблюдать приведенную последовательность.

Создавать новую среду, информационную систему, дата-центр, сегмент сети и структуру организации необязательно: можно использовать уже готовые решения.

1. Создание организации

Пользователь с правами администратора может создавать отдельные организации в Control Panel Cloudlink.

Чтобы создать новую организацию:

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

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

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

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

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

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

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

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

  4. Нажмите Далее, чтобы заполнить параметры на странице Ресурсные квоты:

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

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

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

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

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

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

2. Создание среды

Среда назначается проекту и связывает его с определёнными сетями. К этим сетям подключаются платформы виртуализации. В зависимости от того, какие сети входят в среду, проект получает доступ к разным платформам,если их несколько.

Чтобы создать среду:

  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.

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

    • Назначение среды — укажите назначение среды.

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

      guide organization create env 2

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

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

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

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

  1. Перейдите в сервис Portal Manager по адресу https://portal-manager.sample.box/admin.

  2. На вкладке Информационные системы нажмите Создать Информационная система.

    guide organization info sys 1

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

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

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

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

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

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

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

    • (Опционально) Тип — укажите тип информационной системы.

    • (Опционально) Владелец ИС — укажите владельца информационной системы.

    • (Опционально) Статус — укажите статус информационной системы.

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

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

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

      Окружение организации указывается после создания информационной системы.
      guide organization info sys 2

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

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

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

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

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

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

4. Создание дата-центра

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

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

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

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

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

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

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

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

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

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

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

      guide organization create dc

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

Если сегмент сети создается до дата-центра, он будет доступен для выбора в поле Сегменты сети.

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

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

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

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

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

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

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

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

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

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

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

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

        guide organization create nets

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

7. Создание страницы справочника

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

  1. В Control Panel Cloudlink перейдите в раздел Конструктор → Справочники.

  2. В списке выберите resource_pool.

  3. В разделе resource_pool нажмите Добавить страницу.

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

    • Имя — имя справочника, соответствующее имени платформы.

    • Теги — добавьте тег с именем страницы и тег vm.

    • Степень важности — оставьте по умолчанию.

    • PageData — заполните поле JSON‑описанием ресурсов платформы.

      {
  "data": {
    "resource_pool": {
      "name": "zvirt-test",
      "uuid": "e5e264e4-000-0000-0000000",
      "domain": "zVirt-test-data",
      "endpoint": "https://zvirt-test.cloudlink.box",
      "platform": "zvirt",
      "provider_name": "zvirt"
    }
  },
  "category": "vm",
  "platform": "zvirt"
}

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

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

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

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

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

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

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

      constructor reference books create

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

8. Обновление управляющего хоста

8.1. Обновление конфигурационного файла

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

Добавьте описание нового подключения в файл config.yml, расположенном в каталоге inventories/box/group_vars/{}.

platforms:
  zvirt-test:
    type: zvirt
    label: zvirt-test
    scheme: https
    host: zvirt-test.cloudlink.box
    port: 443
    username: 'user@internal'
    password: '12345'
    params:
      weight: 100
      cluster_id: e5e264e4-000-0000-0000000
      cluster_name: cluster_name
      storage_name: domain_name

Значения параметров соответствуют значениям ранее созданной страницы справочника resource_pool.

Описание всех параметров для разных платформ — в инструкции по установке CloudLink — Настройки файла config.yml.

8.2. Обновление компонента Cloud Mate

После обновления конфигурационного файла на управляющем хосте необходимо обновить компонент Cloud Mate.

Запустите Docker-контейнер командой:

docker run -it --network host --rm \
    -v /$HOME/portal-box:/apps \
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
    -v ~/.kube/cloudlink:/root/.kube/cloudlink \
    -i inventories/box/hosts \
    -u $USER \
    portal_box.yml \
    --ask-vault-pass \
    --tags helmfile-remote,kubeconfig -e '{"helmfile_remote_extra_args": "-l name=cloud-mate"}'

Строка с тегами --tags helmfile-remote,kubeconfig -e '{"helmfile_remote_extra_args": "-l name=cloud-mate"}' необходима, чтобы запустить обновление только компонента Cloud Mate.

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

Параметры команды:

  • -v /$HOME/portal-box:/apps — маппинг директории в которой находится разархивированный архив. Cлева указан путь до директории на manager хосте, справа указан путь до директории в образе docker - неизменяемый, разделителем является ':')

  • -v ~/.ssh/id_rsa:/root/.ssh/id_rsa — маппинг файла с закрытым ключом.

  • -v ~/.kube/cloudlink:/root/.kube/cloudlink — маппинг файл, в котором после будет находится kubeconfig для подключения к кластеру.

  • deploy-manager-1.5.0 — название docker-образа.

  • -i inventories/box/hosts — путь до файла inventory.

  • -u $USER — пользователь, с помощью которого будет производиться подключение на удаленный хост.

  • portal_box.yml  — файл, находящийся в portal-box директории.

После запуска docker-контейнера, введите пароль для установки:

Vault password:
Пароль находится в репозитории с дистрибутивом в файле с расширением txt.

9. Настройка структуры организации

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

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

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

    portal organization management create folder

  4. Введите данные:

    1. Для новой папки:

      • Название — введите название папки.

      • Информационные системы — нажмите на поле и выберите одну систему или более.

      • При необходимости активируйте опцию Создать собственный счет

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

    2. Для нового проекта:

      • Название — введите название проекта.

      • Информационные системы — выберите информационную систему.

      • Из списка выберите нужную Среду.

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

Созданная папка/проект отобразится в Организационной структуре.

10. Настройка сети в сервисе NetBox

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

Учётные данные для входа в сервис NetBox (adminUsername и adminPassword) можно получить из StarVault по адресу https://starvault.sample.box/ui/vault/secrets/deployment/show/netbox.

Чтобы создать сайт:

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

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

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

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

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

    2. Нажмите Create.

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

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

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

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

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

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

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

    3. В Custom Fields в поле Custom virt subnet uuid укажите идентификатор виртуальной подсети. Его можно получить запросом API .

    4. Нажмите Create.

Чтобы создать таблицу маршрутизации:

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

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

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

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

      1. Нажмите Create.

Чтобы создать подсеть:

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

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

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

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

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

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

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

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

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

        • Nameservers — укажите DNS-имя для созданной подсети в формате JSON

    2. Нажмите Create.

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

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

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

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

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

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

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

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

    2. Нажмите Create.