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

Установка сервера управления Nova Universe

В данном разделе документации описаны шаги для установки сервера управления Nova Universe версии 3.x в вашей инфраструктуре.

Установка происходит в два этапа:

  • Установка сервера управления Universe

  • Развертывание платформы Nova SE с помощью утилиты nova-ctl

Nova Universe является модульной системой. При установке основного пакета вы получаете сам Nova Universe и базовый модуль платформы. Для дальнейшей работы необходимо установить дополнительные пакеты, которые содержат репозитории для определенного семейства операционных систем. После завершения установки и настройки сервера управления вы сможете приступить к развертыванию кластеров Nova SE в изолированной сетевой среде.

2. Подготовка виртуальной машины

  1. Создайте виртуальную машину в среде виртуализации. Выделите достаточное количество ресурсов в соответствии с минимальными требованиями конфигурации для установки.

  2. Используйте дистрибутив из списка поддерживаемых операционных систем при установке операционной системы.

  3. Выполните разметку диска и выберите файловую систему:

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

    • При разметке диска и выборе файловой системы учитывайте требования к системе для взаимодействия с API.

    • Конфигурация разметки диска:

      • Рекомендуемая конфигурация: одна точка монтирования с выделением всего дискового пространства.

      • Альтернативная конфигурация: если требуется отдельная разметка, создайте одну точку монтирования, объединяющую следующие директории: /opt, /var и /tmp.

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

    Если SELinux не был выключен до запуска установки, при установке будет произведена попытка его отключить. В этом случае после завершения установки потребуется выполнить перезагрузку системы.

  5. После завершения установки операционной системы выполните базовую настройку сети и укажите желаемое имя хоста для виртуальной машины.

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

2.1. Требования к составу репозиториев

Пакеты Alt Linux 10.2.2
  • cloud-init

  • cloud-utils-growpart

  • python3

  • python3-module-rpm

  • postgresql16-server

  • postgresql16-contrib

  • jq

  • skopeo

  • git

  • ca-certificates

  • rsync

  • wget

  • curl

  • unzip

  • zip

  • tar

  • helm

  • yq

  • acl

  • cracklib-words

  • cracklib

Пакеты МОС ОС 15.5
  • cloud-init

  • python312

  • postgresql16-contrib

  • postgresql16-server

  • jq

  • helm

  • skopeo

  • git-core

  • ca-certificates

  • rsync

  • wget

  • curl

  • unzip

  • zip

  • tar

  • acl

  • cracklib

Пакеты Astra Linux Special Edition 1.7.6, 1.7.9, 1.7.10
  • 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.1, 1.8.3, 1.8.5, 1.8.6
  • cloud-init

  • cloud-guest-utils

  • puppet-agent

  • python3.11

  • python3-pip

  • postgresql-15

  • python3-apt

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

Гипервизор

Пакет для RPM-систем (РЕД ОС)

Пакет для Debian-систем (Astra Linux)

KVM

qemu-guest-agent

qemu-guest-agent

vSphere

open-vm-tools

open-vm-tools

2.2. Требования к системе для взаимодействия с API

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

2.2.1. Требования к файловой системе

Для обеспечения корректной работы и возможности расширения пространства через API необходимо, чтобы выполнялись условия:

  • корневой раздел (/) использовал файловую систему XFS или EXT4

  • директории /opt и /var должны быть частью корневой файловой системы. Наличие отдельных разделов, логических томов (LVM) или точек монтирования для /opt и /var не поддерживается.

  • Управление сетью должно осуществляться исключительно через Network Manager. Если в вашей системе используется иной механизм управления сетью (например, ifupdown, netplan), переключитесь на Network Manager, следуя официальным инструкциям вендора ОС.

Операционная система Документация

Alt Linux

https://www.altlinux.org/NetworkManager

РЕД ОС

https://redos.red-soft.ru/base/redos-7_3/7_3-network/7_3-sett-network/7_3-network-settings/

Astra Linux

https://wiki.astralinux.ru/pages/viewpage.action?pageId=3277370

3. Установка и инициализация Nova Universe

3.1. Предварительные условия

3.2. Подготовительный этап

  1. Создайте директорию для размещения файлов:

    mkdir -p /opt/nova-universe/packages/
  2. Распакуйте артефакты ncp-v1.2.0.tar.gz и universe-v1.2.0.tar.gz, которые находятся на USB-накопителе в комплекте поставки Nova SE, в каталог /opt/nova-universe/packages/:

    tar -xf universe-v1.2.0.tar.gz -C /opt/nova-universe/packages/
    tar -xf ncp-v1.2.0.tar.gz -C /opt/nova-universe/packages/

3.3. Установка и инициализация

  1. Перейдите в директорию /opt/nova-universe/packages/universe/config:

    $ cd /opt/nova-universe/packages/universe/config/
  2. Запустите установку:

    $ sudo ./universe.sh bootstrap
    Пример вывода
    Detected OS: almalinux 8.10
    System is not initialized
  3. Укажите желаемый базовый домен:

    Enter the universe base domain [default: universe.nova.local]:
    universe.mycompany.local
    Base domain successfully changed to universe.mycompany.local ✅
  4. Подтвердите запуск процесса установки:

    Please confirm to start the operation [default: yes]
  5. Дождитесь окончания процесса установки.

    Checking for Python: python3.11...
    Checking for pip3...
    Installing Ansible...
    Ansible installed successfully
    Configuring logging...
    Preparing the system...
    [####################################################################################################] 100% ✓
    System preparation for initialization completed successfully ✅
    Initializing the system...
    [####################################################################################################] 100% ✓
    System initialization completed successfully 🚀
  6. Проверьте состояние установленного ПО:

    $ universe info
    Пример вывода
    System initialized ✅
    
    Universe version: v3.1.4
    
    Public services and resources:
      CA certificate:             https://repo.universe.mycompany.local/ca/ca.crt
      Cluster Manager:            https://cluster-manager.universe.mycompany.local
      Universe API:               https://api.universe.mycompany.local
      Nova API:                   https://nova-api.universe.mycompany.local
      Git service:                https://git.universe.mycompany.local
      Container registry:         https://hub.universe.mycompany.local
      Repository:                 https://repo.universe.mycompany.local
      Uploads service:            https://uploads.universe.mycompany.local
    
    Parameters for Nova Container Platform:
      hubServer:                  sun.universe.mycompany.local
      hubRegistryURL:             https://hub.universe.mycompany.local/nova-universe
      hubToken:                   5894ffe36739070299aebea7b08dfba359d158eb
      hubUsername:                deploy-user
      repoToken:                  5894ffe36739070299aebea7b08dfba359d158eb
      repoURL:                    https://hub.universe.mycompany.local/nova-universe/container-platform-base.git
      rpmRepoURL:                 https://repo.universe.mycompany.local

3.4. Получение корневого сертификата сервера управления

Корневой сертификат Nova Universe по умолчанию не будет являться доверенным на вашей локальной машине. В дальнейшем вы можете столкнуться с ошибками проверки подлинности сертификата хранилища образов, например, при установке nova-ctl. Поэтому рекомендуется добавить сертификат сервера управления в доверенные на локальной машине или машине с которой будет производится установка кластера Nova SE.

  1. Скачайте сертификат:

    curl -ko ca.crt https://repo.universe.mycompany.local/ca/ca.crt
  2. Переместите сертификат в директорию для хранения сертификатов и загрузите сертификат в хранилище с помощью команд:

    Для РЕД ОС
    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

4. Установка пакета репозитория базового модуля

4.1. Предварительные условия

  • Выполнена установка и инициализация Nova Universe.

  • Достаточно свободного пространства для выполнения процедуры установки. Минимальная конфигурация для установки рассчитывается по формуле:

    Свободное пространство ≥ (Размер пакета расширения) × 3

4.2. Подготовительный этап

  1. Скачайте пакет репозитория для нужного семейства операционных систем и расположите его в директории /opt/nova-universe/uploads на целевой машине:

    mv nova-platform-astra-repo-bundle-v1.2.0-un3-rev.2964.upd /opt/nova-universe/uploads/
  2. Перед тем как приступить к установке, убедитесь, что все сервисы функционируют штатно (universe info).

4.3. Установка репозитория

  1. Запустите установку

    $ sudo universe update
    Пример вывода
    System initialized ✅
    The update file must be located in the /opt/nova-universe/uploads directory
    Files found in the /opt/nova-universe/uploads directory:
    nova-platform-astra-repo-bundle-v3.1.4-rev.xxxx.upd
  2. Укажите имя файла:

    Enter the update file name [example: update-universe-bundle-v3.1.4-rev.xxxx.upd]: nova-platform-astra-repo-bundle-v3.1.4-rev.xxxx.upd
  3. Подтвердите запуск процесса установки:

    Please confirm to start the operation [default: yes]
  4. Дождитесь окончания процесса установки расширения.

    Preparing the system for update...
    [####################################################################################################] 100% ✓
    System preparation for update completed successfully ✅
    Updating the system...
    [####################################################################################################] 100% ✓
    System update completed successfully ✅

4.4. Проверка после установки репозитория

После выполнения процедуры убедитесь, что репозиторий установлен.

$ universe info
Пример вывода
System initialized ✅

Universe version: v3.1.4

Nova Platform:
├── Core:                     ✅
├── Repository:
│   ├── ALT Linux:            ❌ Not installed
│   ├── AstraLinux:           ✅
│   ├── Mosos:                ❌ Not installed
│   ├── Redos:                ❌ Not installed
│   ├── Rhel:                 ❌ Not installed
│   └── Ubuntu:               ❌ Not installed
└── Modules:
    ├── Nova M1:
    │   ├── Core:             ❌ Not installed
    │   └── Repository:
    │       ├── AstraLinux:   ❌ Not installed
    │       ├── Redos:        ❌ Not installed
    │       ├── Rhel:         ❌ Not installed
    │       └── Ubuntu:       ❌ Not installed
    └── Nova Operators:
        └── Core:             ❌ Not installed