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

Создание организации с нуля

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. В разделе Создание организации  Общая информация введите параметры:

    • Название — укажите название новой организации

    • Email владельца — укажите электронную почту владельца организации

    • (Опционально)Описание — при необходимости добавьте описание организации

    • dns-серверы — перечислите DNS-сервера организации

    • Размещение любых виртуальных машин на GPU-хостах — чтобы разрешить размещение любых виртуальных машин на GPU-хостах, активируйте опцию

      new org general

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

  5. В разделе Создание организации  Ресурсные квоты введите параметры:

    • Из выпадающего списка выберите подключаемую платформу zVirt.

      Чтобы добавить несколько подключений, нажмите + после добавления первого подключения.

    • Для каждого подключения активируйте ресурсы и укажите размер ресурсных квот:

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

      • CPU — количество центральных процессоров, доступное для заказов на организацию

      • RAM — количество оперативной памяти в ГБ, доступное для заказов на организацию

      • Диски — размер всех дисков для заказов на организацию

        new org quotas

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

  7. В разделе Создание организации  Итог проверьте параметры новой организации и нажмите Создать новую организацию, если параметры верны.

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

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

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

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

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

    environments list org0

  3. В разделе Создать Среда заполните поля:

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

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

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

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

      create env org0

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

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

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

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

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

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

    info sys org0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

К информационной системе может быть привязано несколько сред.

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

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

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

  1. На портале администрирования перейдите в Инфраструктура  Дата-центры и нажмите Создать дата-центр.

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

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

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

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

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

      • (Опционально) Вес — из выпадающего списка выберите вес

      • (Опционально) Сегменты сети — на данном этапе новый сегмент сети еще не создан, поэтому не задается

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

      new dc org0

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

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

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

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

  1. На портале администрирования перейдите в Инфраструктура  Сегменты сети и нажмите Создать сегмент сети.

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

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

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

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

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

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

      • Дата-центры — из выпадающего списка выберите созданный ранее дата-центр

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

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

        net segm org0

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

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

  1. На портале администрирования перейдите в Инфраструктура  Дата-центры.

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

  3. В окне Редактирование дата-центра проверьте, что в поле Сегменты сети указан созданный сегмент сети.

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

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

  1. На портале администрирования перейдите в Инфраструктура  Платформы и нажмите Создать платформу.

  2. В окне Создать платформу:

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

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

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

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

      • (Опционально) Вес — из выпадающего списка выберите вес

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

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

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

  2. В окне Редактирование платформы:

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

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

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

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

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

  1. На портале администрирования перейдите в Конструктор  Справочники.

  2. В списке справочников выберите resource_pool.

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

  4. В окне Добавить новую страницу в resource_pool заполните поля:

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

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

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

      {
  "data": {
    "resource_pool": {
      "name":"Default", (1)
      "uuid":"d90193d6-5c5a-11ee-bd56-00163e10167d", (2)
      "domain":"domain_name", (3)
      "endpoint":"https://sample.box.zvirt.loc/ovirt-engine", (4)
      "platform":"zvirt", (5)
      "provider_name":"zvirt_provider_name" (6)
  },
  },
  "category":"vm", (7)
  "platform":"zvirt1" (5)
}
      1 name — имя кластера
      2 uuid — идентификатор кластера
      3 domain — имя домена хранения
      4 endpoint — URL портала администрирования zVirt
      5 platform — тип платформы виртуализации — zVirt
      6 provider_name — имя провайдера
      7 category — категория использования, значение vm означает, что платформа используется для размещения виртуальных машин

      Можно скопировать значения параметров name, uuid и domain на портале администрирования zVirt:

      • Перейдите в Ресурсы  Кластеры и скопируйте имя нужного кластера для name.

      • Перейдите в Ресурсы  Кластеры, нажмите имя кластера и скопируйте идентификатор кластера в строке ID кластера для uuid.

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

    • Теги — укажите тег с именем новой страницы справочника и нажмите +, аналогично добавьте тег vm

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

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

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

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

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

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

 platforms:
  zvirt1: (1)
    type: zvirt
    label: zVirt1 (2)
    scheme: https
    host: sample.box.zvirt.loc (3)
    port: 443
    username: 'admin@zvirt@internalsso'
    password: '12345'
    params:
      weight: 100
      cluster_id: d90193d6-5c5a-11ee-bd56-00163e10167d (4)
      cluster_name: cluster_name (5)
      storage_name: domain_name (6)

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

1 имя платформы — аналогично имени платформы и имени страницы справочника resource_pool
2 label — аналогично имени платформы и имени страницы справочника resource_pool
3 host — значение endpoint в поле PageData без https://
4 cluster_id — аналогично значению параметра uuid в поле PageData
5 cluster_name — аналогично значению параметра name в поле PageData
6 storage_name — аналогично значению параметра domain в поле PageData

Описание всех параметров — в Подготовка управляющего хоста.

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

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

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

Кроме последней строки, параметры команды аналогичны тем, что задавались на этапе развертывания модуля zVirt DC Manager.

 
docker run -it --network host --rm \
    -v /$HOME/portal-box:/apps \
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
    -v ~/.kube/dcmanager:/root/.kube/dcmanager \
    deploy-manager:1.8.1 \
    -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.

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

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

Vault password:

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

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

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

Папки и проекты создаются на пользовательском портале под учетной записью администратора.

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

  1. Активируйте контекст проекта:

    1. Из выпадающего списка Организация выберите организацию.

    2. В иерархической структуре организации выберите созданный проект.

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

  3. Напротив организации нажмите ⋮ и выберите Создать папку.

  4. В окне Создание новой папки:

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

      • Имя папки — укажите имя новой папки

      • Информационные системы — из выпадающего списка выберите созданную ранее информационную систему

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

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

  1. Напротив папки нажмите ⋮ и выберите Создать проект.

  2. В окне Создание проекта:

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

      • Имя проекта — укажите имя нового проекта

      • Информационные системы — из выпадающего списка выберите созданную ранее информационную систему

      • Среда — из выпадающего списка выберите созданную ранее среду

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

После настройки структуры организации вы можете проверить доступность платформы:

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

  2. В разделе Новый заказ выберите карточку продукта.

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

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. Заполните поля:

    2. Нажмите Create.

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

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

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

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

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

    3. В Custom Fields в поле Custom virt subnet uuid укажите профиль vNIC из платформы zVirt.

      Чтобы получить профиль vNIC на портале администрирования zVirt, перейдите в Сеть  Профили vNIC и скопируйте ID.

      vnicprofile

    4. Нажмите Create.

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

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

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

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

    2. Нажмите Create.

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

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

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

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

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

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

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

        На портале администрирования zVirt перейдите в Ресурсы  Кластеры, нажмите имя кластера и скопируйте идентификатор кластера в строке ID Кластера.

      • 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.