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

Миграция кластеров с Nova Universe v2 на Nova Universe v3

Следующие обновления Nova SE будут поддерживаться только на Universe v3.

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

  • Целевой сервер управления Nova Universe v3 развернут и инициализирован.

  • Версия мигрируемого кластера должна быть v1.2.0.

  • Миграция осуществляется с помощью nova-ctl:v1.2.0, поставляемой в составе Nova Universe v3.

  • Проверьте сетевые правила для целевой инсталляции Nova Universe v3 (требования к межсетевому экранированию руководства по установке).

  • На всех узлах мигрируемого кластера Nova Container Platform настроена системная локаль en_US.UTF-8.

2. Миграция кластера

  1. Загрузите образ nova-ctl v1.2.0:

    docker pull hub.universe.nova.local/nova-universe/nova/nova-ctl:v1.2.0
  2. Проверьте, что системная локаль сервера управления Nova Universe v2 установлена в значение en_US.UTF-8:

    locale

    Если локаль отличается от en_US.UTF-8, измените ее в соответствии с документацией используемой операционной системы и перезапустите пользовательскую сессию либо сервер управления. После изменения повторно выполните команду locale и убедитесь, что установлено значение en_US.UTF-8.

  3. Выполните команду для запуска контейнера с утилитой nova-ctl:

    docker run --rm -it -v $PWD:/opt/nova hub.universe.nova.local/nova-universe/nova/nova-ctl:v1.2.0
  4. Выполните команду для миграции кластера на Universe v3:

    nova-ctl cluster migrate --ssh-key nova-packer.pem --ssh-user nova-user --base-domain universe.ok6.f04.test --starvault-root-token hvs.VbydAiQYsCViNPwQhiwYI5Qs --hub-registry-url hub.universe.ok6.f04.test/nova-universe --hub-token 5694b1c9a2a553246c19eb4850af095c80fac466 --hub-username deploy-user --repo-url https://hub.universe.ok6.f04.test/nova-universe/container-platform-base.git --repo-token 5694b1c9a2a553246c19eb4850af095c80fac466 --rpm-repo-url https://repo.universe.ok6.f04.test

    Где:

    • --ssh-key — путь к файлу приватного SSH-ключа для подключения к узлам мигрируемого кластера.

    • --ssh-user — имя пользователя SSH для подключения к узлам кластера.

    • --base-domain — базовый домен целевой инсталляции Nova Universe v3, в которую переносится кластер.

    • --starvault-root-token — корневой токен доступа (root) к хранилищу секретов StarVault.

    • --hub-registry-url — адрес хранилища образов (container registry) Nova Universe v3, включает путь к проекту, например hub.universe.<domain>/nova-universe.

    • --hub-token — токен доступа (deploy-token) к хранилищу образов Nova Universe v3, для входа под hub-username. Получается после установки сервера управления Nova Universe v3.

    • --hub-username — имя пользователя для доступа к хранилищу образов. По умолчанию — deploy-user.

    • --repo-url — URL git-репозитория container-platform-base.git Nova Universe v3.

    • --repo-token — токен доступа (deploy-token) к репозиториям Nova Universe v3. В манифестах устанавливается тем же значением, что и hub-token.

    • --rpm-repo-url — URL репозитория пакетов (rpm/deb) Nova Universe v3, например https://repo.universe.<domain>;.

      Данные параметры вы можете найти на инициализированном Nova Universe v3:

      universe info
      Пример вывода
      System initialized ✅
      
      Universe version: v1.2.0-un3
      
      Public services and resources:
        CA certificate:             https://repo.universe.ok6.f04.test/ca/ca.crt
        Git service:                https://hub.universe.ok6.f04.test
        Container registry:         https://hub.universe.ok6.f04.test
        Repository:                 https://repo.universe.ok6.f04.test
        Uploads service:            https://uploads.universe.ok6.f04.test
      
      Service status:
        K3s:                        ✅
        PostgreSQL:                 ✅
        Git service:                ✅
        Container registry:         ✅
        Repository:                 ✅
        Uploads service:            ✅
      
      Parameters for Nova Container Platform:
        coreServer:                 sun.universe.ok6.f04.test
        hubRegistryURL:             hub.universe.ok6.f04.test/nova-universe
        hubToken:                   5694b1c9a2a553246c19eb4850af095c80fac466
        hubUsername:                deploy-user
        repoToken:                  5694b1c9a2a553246c19eb4850af095c80fac466
        repoURL:                    https://hub.universe.ok6.f04.test/nova-universe/container-platform-base.git
        rpmRepoURL:                 https://repo.universe.ok6.f04.test
      
      Nova Platform:
      ├── Core:                     ✅
      ├── Repository:
      │   ├── ALT Linux:            ✅
      │   ├── AstraLinux:           ✅
      │   ├── Mosos:                ✅
      │   └── Redos:                ✅
  5. Дождитесь сообщения об успешной миграции кластера:

    ■ Validating cluster nodes... done
    
    🚀 The cluster has been migrated successfully