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

Установка 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 выполните следующие действия:

  1. Установите ОС и выполните разметку диска:

    • Для корневого раздела / выберите файловую систему XFS или EXT4.

    • Используйте рекомендуемую конфигурацию: одна точка монтирования / с выделением всего доступного дискового пространства.

    • При использовании другой разметки оставьте каталоги /opt, /var и /tmp в корневой файловой системе. Отдельные разделы и точки монтирования для /opt и /var не поддерживаются при работе через API.

      Не выделяйте отдельную точку монтирования для /tmp. Каталог используется для предварительных операций при установке обновлений и модулей. Переполнение отдельного раздела может привести к сбою этих операций.
  2. Настройте сеть и имя хоста. Для управления сетью используйте только NetworkManager.

  3. Перед началом установки отключите межсетевой экран и SELinux.

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

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

qemu-guest-agent

qemu-guest-agent

vSphere

open-vm-tools

open-vm-tools

4. Подготовка DNS

Перед началом установки настройте DNS-записи для базового домена Nova Universe и его поддоменов.

В примерах ниже:

  • universe.example.ru — базовое доменное имя Nova Universe.

  • 192.168.1.2 — IP-адрес ВМ с Nova Universe.

Замените значения примеров данными вашего сервера.

  1. На DNS-сервере создайте следующие A-записи:

    Имя IP-адрес

    universe.example.ru

    192.168.1.2

    *.universe.example.ru

    192.168.1.2

  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

  1. Получите дистрибутив Nova Universe 3.1 или выше.

  2. Скопируйте архив на виртуальной машине и распакуйте его, заменив <имя_архива> его именем:

    sudo tar -xf <имя_архива> -C /opt/
  3. Запустите автоматизированную установку:

    cd /opt/nova-universe/packages/universe/config/
    sudo ./universe.sh bootstrap
  4. Введите базовое DNS-имя, для которого подготовлены DNS-записи, например universe.example.ru. Подтвердите установку и дождитесь завершения.

    При инициализации Nova Universe скрипт создает системного пользователя universe с паролем universe по умолчанию. Учетная запись используется внутренними сервисами. Ее удаление приведет к нарушению их работы. Если прямой доступ к системе под этой учетной записью не требуется, после завершения установки можно заблокировать вход под пользователем universe.
  5. После инициализации рекомендуется перезагрузить ВМ:

    sudo reboot
  6. После запуска сервисов проверьте состояние:

    universe info

5.1. Получение корневого сертификата Nova Universe

На виртуальной машине, с которой выполняются запросы к API Nova Universe, загрузите корневой сертификат и добавьте его в системное хранилище доверенных сертификатов.

Для этого:

  1. На виртуальных машинах с установленной Nova Universe выполните следующую команду:

     universe info
  2. Скопируйте адрес из поля CA certificate.

  3. На машине, с которой выполняются запросы к API, загрузите сертификат. В команде замените URL адресом из поля CA certificate:

    curl -ko ca.crt https://repo.universe.example.ru/ca/ca.crt
  4. Добавьте сертификат в системное хранилище. Выполните команды для используемой ОС:

    РЕД ОС и AlmaLinux
    sudo mv ca.crt /etc/pki/ca-trust/source/anchors/universe-ca.crt
    sudo update-ca-trust
    Astra 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.

Для создания пароля:

  1. Авторизуйтесь на виртуальной машине, где корневой сертификат Nova Universe добавлен в доверенные.

  2. Выполните запрос на изменение пароля:

    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 своим паролем.

  3. При настройке подключения укажите заданный пароль в параметре nova_universe_api_password или в соответствующем поле интерфейса manage-tool.

6.2. Пароль Cluster Manager

Пароль учетной записи Cluster Manager и пароль API настраиваются отдельно. Для подключения Cloudlink используйте пароль, заданный запросом к API.
  1. Откройте веб-интерфейс Cluster Manager по адресу https://cluster-manager.universe.example.ru, заменив universe.example.ru базовым DNS-именем вашего сервера Nova Universe.

  2. Войдите с учетными данными по умолчанию:

    • Имя пользователя: admin.

    • Пароль: password.

  3. Задайте новый пароль учетной записи admin через веб-интерфейс.

7. Загрузка репозиториев ОС

Загрузите в Nova Universe репозитории для операционных систем, на которых планируется развертывать кластеры Nova Container Platform, например Astra Linux (astra), РЕД ОС (redos), RHEL (rhel), Ubuntu (ubuntu) или ALT Linux (alt).

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

  1. Получите пакет репозитория, совместимый с Nova Universe 3.1 или выше.

  2. Скопируйте файл пакета в каталог /opt/nova-universe/uploads на ВМ с Nova Universe.

  3. На этой ВМ запустите установку пакета:

    sudo universe update

    В команде появится запрос на название пакета репозитория

  4. Укажите название загруженного файла пакета. Дождитесь завершения установки.

    Когда оба репозитория будут установлены, проверьте состояние сервисов и наличие установленных расширений.

  5. Введите команду:

universe info
  1. Авторизуйтесь на виртуальной машине с установленной Nova Universe.

  2. Выполните команду, что получить значения hubUsername и hubToken:

    universe info
  3. Сохраните значения hubUsername и hubToken из вывода команды.

  4. На управляющем хосте 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

  1. На управляющем хосте Cloudlink, который содержит скрипт manage-tool.sh, запустите интерфейс настройки:

    ./manage-tool.sh --ui
  2. Укажите базовое DNS-имя Nova Universe, значения hubUsername и hubToken, а также ранее заданный пароль API.

  3. При запросе пароля Ansible Vault для сохранения hubToken и apiPassword введите пароль из файла password-playbook.txt в репозитории Cloudlink.

  4. Сохраните настройки.

  5. Выполните повторное развертывание Cloudlink на управляющем хосте, чтобы применить изменения.