Установка Nova Universe для Cloudlink
1. Подготовка к заказу Nova Container Platform
Перед заказом Nova Container Platform в Cloudlink разверните и настройте сервер управления Nova Universe.
Начиная с версии 1.42, Cloudlink поддерживает только Nova Universe версии 3.1 и выше. В этой инструкции описана подготовка Nova Universe 3.1.3. После установки убедитесь, что в выводе команды universe info отображается Universe version: v3.1.3.
|
2. Подготовка виртуальной машины
Выделите для ВМ не менее следующих ресурсов:
| vCPU | RAM, ГБ | Диск, ГБ | IOPS |
|---|---|---|---|
4 |
16 |
246 |
300+ |
Для Nova Universe 3.1.3 поддерживаются следующие операционные системы(ОС):
| ОС | Версии |
|---|---|
AlmaLinux |
8.10, 9.6, 9.7 |
РЕД ОС |
7.3.4, 7.3.5, 7.3.6, 8.0.2 |
Astra Linux Special Edition |
1.7.6, 1.7.9, 1.8.1, 1.8.3 |
ALT Linux |
11.0, 10.2 |
Ubuntu |
24.04 |
Для подготовки виртуальной машины к установке Nova Universe выполните следующие действия:
-
Установите ОС и выполните разметку диска:
-
Для корневого раздела
/выберите файловую систему XFS или EXT4. -
Используйте рекомендуемую конфигурацию: одна точка монтирования
/с выделением всего доступного дискового пространства. -
При использовании другой разметки оставьте каталоги
/opt,/varи/tmpв корневой файловой системе. Отдельные разделы и точки монтирования для/optи/varне поддерживаются при работе через API.Не выделяйте отдельную точку монтирования для /tmp. Каталог используется для предварительных операций при установке обновлений и модулей. Переполнение отдельного раздела может привести к сбою этих операций.
-
-
Настройте сеть и имя хоста. Для управления сетью используйте только NetworkManager.
-
Перед началом установки отключите межсетевой экран и SELinux.
-
Подключите официальные репозитории выбранного дистрибутива ОС или их локальные зеркала. Убедитесь, что репозитории содержат пакеты и модули, перечисленные ниже для используемой ОС.
3. Требования к составу репозиториев
Astra Linux Special Edition 1.7
Необходимые пакеты:
-
cloud-init -
cloud-guest-utils -
puppet-agent -
python3.7 -
python3-pip -
python3-apt -
postgresql-11 -
postgresql-contrib -
jq -
git -
ca-certificates -
rsync -
wget -
curl -
unzip -
zip -
tar -
acl -
chrony
Astra Linux Special Edition 1.8
Необходимые пакеты:
-
cloud-init -
cloud-guest-utils -
puppet-agent -
python3.11 -
python3-pip -
python3-apt -
postgresql-15 -
postgresql-contrib -
jq -
git -
ca-certificates -
rsync -
wget -
curl -
unzip -
zip -
tar -
acl -
chrony
РЕД ОС 7.3
Необходимые пакеты:
-
cloud-init -
cloud-utils-growpart -
puppet-7.12.0-7.el7.x86_64 -
python3 -
libffi-devel -
python3-devel -
postgresql-contrib -
postgresql15-server -
postgresql15-contrib -
jq -
git -
ca-certificates -
rsync -
wget -
curl -
unzip -
zip -
tar -
helm -
yq -
acl -
skopeo
РЕД ОС 8.0.2
Необходимые пакеты:
-
cloud-init -
cloud-utils-growpart -
python3 -
libffi-devel -
python3-devel -
postgresql-contrib -
postgresql15-server -
postgresql15-contrib -
jq -
git -
ca-certificates -
rsync -
wget -
curl -
unzip -
zip -
tar -
helm -
yq -
acl -
skopeo
AlmaLinux 8.10
Необходимый модуль: @postgresql:15.
Необходимые пакеты:
-
cloud-init-23.4-7.el8_10.9.alma.1 -
cloud-utils-growpart -
python3.11 -
postgresql-contrib -
jq -
git -
ca-certificates -
rsync -
wget -
curl -
unzip -
zip -
tar -
acl -
skopeo
Проверьте доступ к основным пакетам для гипервизоров:
| Гипервизор | Пакет для RPM-систем (AlmaLinux, РЕД ОС) | Пакет для Debian-систем (Astra Linux) |
|---|---|---|
KVM |
|
|
vSphere |
|
|
4. Подготовка DNS
Перед началом установки настройте DNS-записи для базового домена Nova Universe и его поддоменов.
В примерах ниже:
-
universe.example.ru— базовое доменное имя Nova Universe. -
192.168.1.2— IP-адрес ВМ с Nova Universe.
Замените значения примеров данными вашего сервера.
-
На DNS-сервере создайте следующие A-записи:
Имя IP-адрес universe.example.ru192.168.1.2*.universe.example.ru192.168.1.2 -
Если создание wildcard-записи
*.universe.example.ruнедоступно, вместо нее создайте отдельные A-записи для следующих поддоменов. Для каждой записи укажите IP-адрес ВМ с Nova Universe:-
hub.universe.example.ru -
sun.universe.example.ru -
repo.universe.example.ru -
cluster-manager.universe.example.ru -
api.universe.example.ru -
nova-api.universe.example.ru -
uploads.universe.example.ruСохраните A-запись для базового домена
universe.example.ru.
-
5. Установка и инициализация Nova Universe
-
Получите дистрибутив Nova Universe 3.1 или выше.
-
Скопируйте архив на виртуальной машине и распакуйте его, заменив
<имя_архива>его именем:sudo tar -xf <имя_архива> -C /opt/ -
Запустите автоматизированную установку:
cd /opt/nova-universe/packages/universe/config/ sudo ./universe.sh bootstrap -
Введите базовое DNS-имя, для которого подготовлены DNS-записи, например
universe.example.ru. Подтвердите установку и дождитесь завершения.При инициализации Nova Universe скрипт создает системного пользователя universeс паролемuniverseпо умолчанию. Учетная запись используется внутренними сервисами. Ее удаление приведет к нарушению их работы. Если прямой доступ к системе под этой учетной записью не требуется, после завершения установки можно заблокировать вход под пользователемuniverse. -
После инициализации рекомендуется перезагрузить ВМ:
sudo reboot -
После запуска сервисов проверьте состояние:
universe info
5.1. Получение корневого сертификата Nova Universe
На виртуальной машине, с которой выполняются запросы к API Nova Universe, загрузите корневой сертификат и добавьте его в системное хранилище доверенных сертификатов.
Для этого:
-
На виртуальных машинах с установленной Nova Universe выполните следующую команду:
universe info -
Скопируйте адрес из поля CA certificate.
-
На машине, с которой выполняются запросы к API, загрузите сертификат. В команде замените URL адресом из поля CA certificate:
curl -ko ca.crt https://repo.universe.example.ru/ca/ca.crt -
Добавьте сертификат в системное хранилище. Выполните команды для используемой ОС:
РЕД ОС и AlmaLinux
sudo mv ca.crt /etc/pki/ca-trust/source/anchors/universe-ca.crt sudo update-ca-trustAstra Linux
sudo mv ca.crt /usr/local/share/ca-certificates/universe-ca.crt sudo update-ca-certificates
6. Настройка паролей
6.1. Пароль API
По умолчанию пароль API не заполнен. Задайте пароль и сохраните его для настройки подключения Cloudlink к Nova Universe.
Для создания пароля:
-
Авторизуйтесь на виртуальной машине, где корневой сертификат Nova Universe добавлен в доверенные.
-
Выполните запрос на изменение пароля:
curl --location --request PUT 'https://nova-api.universe.example.ru/api/v2/auth/password' \ --header 'Content-Type: application/json' \ --data '{ "currentPassword": "", "newPassword": "somepassword" }'Замените данные из примера вашими данными:
-
universe.example.ru— базовое DNS-имя вашего сервера Nova Universe. -
currentPassword— текущий пароль API. При первом изменении укажите пустую строку"". -
newPassword— новый пароль API. Заменитеsomepasswordсвоим паролем.
-
-
При настройке подключения укажите заданный пароль в параметре
nova_universe_api_passwordили в соответствующем поле интерфейсаmanage-tool.
6.2. Пароль Cluster Manager
| Пароль учетной записи Cluster Manager и пароль API настраиваются отдельно. Для подключения Cloudlink используйте пароль, заданный запросом к API. |
-
Откройте веб-интерфейс Cluster Manager по адресу
https://cluster-manager.universe.example.ru, заменивuniverse.example.ruбазовым DNS-именем вашего сервера Nova Universe. -
Войдите с учетными данными по умолчанию:
-
Имя пользователя:
admin. -
Пароль:
password.
-
-
Задайте новый пароль учетной записи
adminчерез веб-интерфейс.
7. Загрузка репозиториев ОС
Загрузите в Nova Universe репозитории для операционных систем, на которых планируется развертывать кластеры Nova Container Platform, например Astra Linux (astra), РЕД ОС (redos), RHEL (rhel), Ubuntu (ubuntu) или ALT Linux (alt).
Для каждого выбранного репозитория выполните следующие действия:
-
Получите пакет репозитория, совместимый с Nova Universe 3.1 или выше.
-
Скопируйте файл пакета в каталог
/opt/nova-universe/uploadsна ВМ с Nova Universe. -
На этой ВМ запустите установку пакета:
sudo universe updateВ команде появится запрос на название пакета репозитория
-
Укажите название загруженного файла пакета. Дождитесь завершения установки.
Когда оба репозитория будут установлены, проверьте состояние сервисов и наличие установленных расширений.
-
Введите команду:
universe info
8. Настройка подключения Cloudlink к Nova Universe
-
Авторизуйтесь на виртуальной машине с установленной Nova Universe.
-
Выполните команду, что получить значения
hubUsernameиhubToken:universe info -
Сохраните значения
hubUsernameиhubTokenиз вывода команды. -
На управляющем хосте Cloudlink задайте параметры подключения одним из следующих способов.
8.1. Настройка в файле конфигурации
В файле portal-box/inventories/box/group_vars/k3s/config.yml укажите базовое DNS-имя Nova Universe, учетные данные хранилища образов и ранее заданный пароль API:
# Базовое DNS-имя Nova Universe.
nova_universe_base_domain: 'universe.example.ru'
# Значения hubUsername и hubToken из вывода universe info.
nova_universe_hub_username: '<hubUsername>'
nova_universe_hub_token: '<hubToken>'
# Пароль, заданный запросом к API.
nova_universe_api_password: 'somepassword'
Замените значения примера данными своего сервера.
8.2. Настройка через manage-tool
-
На управляющем хосте Cloudlink, который содержит скрипт
manage-tool.sh, запустите интерфейс настройки:./manage-tool.sh --uiПодробнее — в инструкции по настройке manage-tool -
Укажите базовое DNS-имя Nova Universe, значения
hubUsernameиhubToken, а также ранее заданный пароль API. -
При запросе пароля Ansible Vault для сохранения
hubTokenиapiPasswordвведите пароль из файлаpassword-playbook.txtв репозитории Cloudlink. -
Сохраните настройки.
-
Выполните повторное развертывание Cloudlink на управляющем хосте, чтобы применить изменения.