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

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

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

Создание новой организации
Создание среды
Создание информационной системы
Создание дата-центра, сегмента сети для организации и платформы
Создание страницы справочника
Обновление управляющего хоста
Настройка структуры организации
Настройка сети для виртуальных машин

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

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

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

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

На портале администрирования перейдите в Управление доступом Организации.
Нажмите +Создать.
В разделе Создание организации Общая информация введите параметры:
- Название — укажите название новой организации
- Email владельца — укажите электронную почту владельца организации
- (Опционально)Описание — при необходимости добавьте описание организации
- dns-серверы — перечислите DNS-сервера организации
- Размещение любых виртуальных машин на GPU-хостах — чтобы разрешить размещение любых виртуальных машин на GPU-хостах, активируйте опцию
Нажмите Далее.

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

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

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

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

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

CPU — количество центральных процессоров, доступное для заказов на организацию
RAM — количество оперативной памяти в ГБ, доступное для заказов на организацию
Диски — размер всех дисков для заказов на организацию
RAM (GPU) — количество видеопамяти в ГБ для графических процессоров, доступное для заказов на организацию

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

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

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

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

Перейдите на сервис Portal Manager по адресу https://portal-manager.sample.box/admin.
На вкладке Среды нажмите Создать Среда.
В разделе Создать Среда заполните поля:
- Tип — выберите тип среды из значений по умолчанию: TEST, DEV или PROD
- Название — укажите 4 заглавные буквы
  
  Длина и регистр зафиксированы: значение поля — 4 заглавные буквы.
- Назначение среды — укажите назначение среды
- Организация — в выпадающем списке выберите название созданной организации.
Нажмите Создать.

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

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

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

Перейдите на сервис Portal Manager по адресу https://portal-manager.sample.box/admin.
На вкладке Информационные системы нажмите Создать Информационная система.
В разделе Создать Информационная система заполните поля:
- Название — укажите название информационной системы
- (Опционально) Короткое название — укажите короткое название информационной системы
- Код ИС — укажите 4 строчные буквы
  
  Длина и регистр зафиксированы: значение поля — 4 строчные буквы.
- (Опционально) Короткий код — укажите короткий код информационной системы
- (Опционально) Тип — укажите тип информационной системы
- (Опционально) Владелец ИС — укажите владельца информационной системы
- (Опционально) Статус — укажите статус информационной системы
- Приоритет — по умолчанию 2
- Организация — в выпадающем списке выберите созданную ранее организацию.
- Окружения организации — на данном этапе в выпадающем списке отсутствуют значения
  
  Окружение организации указывается после создания информационной системы.
Нажмите Создать.

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

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

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

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

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

На портале администрирования перейдите в Инфраструктура Дата-центры и нажмите Создать дата-центр.
В окне Создать дата-центр:
1. Заполните поля:
  - Код — укажите код дата-центра
  - Обозначение латиницей — укажите обозначение дата-центра на латинице, оно может совпадать с кодом
  - Организация — в выпадающем списке выберите созданную ранее организацию
  - (Опционально) Вес — в выпадающем списке выберите вес
  - (Опционально) Сегменты сети — на данном этапе новый сегмент сети еще не создан, поэтому не задается
2. Включите опцию Доступен на форме заказа.
3. Нажмите Создать.

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

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

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

На портале администрирования перейдите в Инфраструктура Сегменты сети и нажмите Создать сегмент сети.
В окне Создать сегмент сети:
1. Заполните поля:
  - Название — укажите название сегмента сети
  - Код — укажите код сегмента сети, он может совпадать с названием
  - Организация — в выпадающем списке выберите созданную ранее организацию
  - (Опционально) Вес — в выпадающем списке выберите вес
  - Дата-центры — в выпадающем списке выберите созданный ранее дата-центр
  - Среды — в выпадающем списке выберите одну или несколько созданных ранее сред
  - (Опционально) Домены — оставьте поле пустым
2. Нажмите Создать.

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

Перейдите в Инфраструктура Дата-центры.
Напротив нужного дата-центра нажмите ⋮ и выберите Редактировать.
В окне Редактирование дата-центра проверьте, что в поле Сегменты сети указан созданный сегмент сети.

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

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

На портале администрирования перейдите в Инфраструктура Платформы и нажмите Создать платформу.
В окне Создать платформу:
1. Заполните поля:
  - Название — укажите название платформы
  - Код — укажите название платформы, он может совпадать с названием
  - Организация — в выпадающем списке выберите созданную ранее организацию
  - (Опционально) Вес — в выпадающем списке выберите вес
2. Нажмите Создать.

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

Нажмите ⋮ напротив созданной платформы и выберите Редактировать.
В окне Редактирование платформы:
1. В поле Сегменты сети выберите из выпадающего списка созданный ранее сегмент сети.
2. В поле Дата-центры выберите из выпадающего списка созданный ранее дата-центр.
3. Нажмите Сохранить.

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

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

На портале администрирования перейдите в Конструктор Справочники.
В списке справочников выберите resource_pool.
В разделе resource_pool нажмите +Добавить страницу.

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

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

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

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

{
  "data": {
    "resource_pool": {
      "name":"cluster_name", (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 — имя провайдера

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

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

Перейдите в Ресурсы Кластеры и скопируйте имя нужного кластера для name.
Перейдите в Ресурсы Кластеры, нажмите имя кластера и скопируйте идентификатор кластера в строке ID Кластера для uuid.
Перейдите в Хранилище Домены и скопируйте имя нужного домена из списка для domain.

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

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

storage_name — аналогично значению параметра domain в поле PageData

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

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/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"}'

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

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

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

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

Vault password:

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

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

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

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

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

Активируйте контекст проекта:
1. В выпадающем списке Организация выберите организацию.
2. В иерархической структуре организации выберите созданный проект.
Перейдите в Управление доступом.
Напротив организации нажмите ⋮ и выберите Создать папку.
В окне Создание новой папки:
1. Заполните поля:
  - Имя папки — укажите имя новой папки
  - Информационные системы — в выпадающем списке выберите созданную ранее информационную систему
2. Нажмите Создать.

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

Напротив папки нажмите ⋮ и выберите Создать проект.
В окне Создание проекта:
1. Заполните поля:
  - Имя проекта — укажите имя нового проекта
  - Информационные системы — в выпадающем списке выберите созданную ранее информационную систему
  - Среда — в выпадающем списке выберите созданную ранее среду
2. Нажмите Создать.

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

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

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

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

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

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

Перейдите в раздел Organization Sites и нажмите +Add.
В разделе Add a new site:
1. Заполните поля:
  - Name — совпадает с кодом дата-центра
  - Slug — совпадает с кодом дата-центра
2. Нажмите Create.

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

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

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

Заполните поля:
- ID — произвольное значение
- Name — совпадает с кодом сегмента сети
В Assignment Site в поле Site выберите имя созданного ранее сайта (дата-центра) из выпадающего списка.

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

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

Нажмите Create.

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

Перейдите в раздел IPAM VRFs и нажмите +Add.
В разделе Add a new VRF:
1. Заполните поля:
  - Name — совпадает с кодом сегмента сети
  - RD — совпадает с кодом сегмента сети
2. Нажмите Create.

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

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

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

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

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

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

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

Site — в выпадающем списке выберите имя созданного ранее сайта
VLAN — в выпадающем списке выберите имя созданной ранее виртуальной локальной сети
Default gw — укажите IP-адрес шлюза по умолчанию для создаваемых виртуальных машин
Nameservers — укажите DNS-имя для созданной подсети в формате JSON

Нажмите Create.

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

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

Перейдите в раздел IPAM IP Ranges и нажмите +Add.
В разделе Add a new IP range:
1. Заполните поля:
  - VRF — в выпадающем списке выберите имя созданного ранее домена маршрутизации и пересылки
  - Start address — укажите начальный IP-адрес диапазона запрещенных к использованию IP-адресов
  - End address — укажите конечный IP-адрес диапазона запрещенных к использованию IP-адресов
2. Нажмите Create.