Перейти к содержанию

Обновление модуля управления облаком

Внимание

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

Все команды обновления модуля управления облаком выполняются от имени пользователя с привилегиями sudo.

Возможен запуск обновления от имени пользователя, входящего в группу docker, при условии, что он является владельцем директории обновляемой установки модуля управления облаком. Добавить пользователя дополнительно в группу docker можно командой:

sudo usermod -aG docker $USER|<USERNAME>

Недоступность портала для пользователей во время обновления возможна до 30 секунд.

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

  1. Загрузить установочный файл новой версии модуля управления облаком на ВМ, на которой установлена текущая версия модуля.

  2. Назначить права для установочного файла новой версии:

    sudo chmod +x <installer_name>.run

    Необходимо заменить <installer_name> на имя установочного файла.

    Пример команды 
    sudo chmod +x sc-1.2-installer.run

  3. Запустить установку:

    sudo ./<installer_name>.run

    Начнется проверка целостности и распаковка файла установщика. Производится проверка ВМ на соответствие требованиям к установке платформы. В случае успешной проверки отобразится сообщение: «Проверка всех требований прошла успешно!».

    Примечание

    При обновлении оценка требуемого доступного дискового пространства аналогична чистой установке в 20 ГБ. Предполагается, что 20 ГБ достаточно для полной установки модуля управления облаком и сохранения двух предыдущих версий контейнеров после обновлений. Если на момент обновления доступного дискового пространства окажется меньше требуемого, можно обойти проверку, запустив установщик с ключом --nocheck.

    sudo ./<installer_name>.run -- --nocheck

    При этом необходимо учитывать требование 5 ГБ дискового пространства под временные файлы на период обновления и понимать потенциальные риски дефицита места на диске после обновления.

    Проверка требований к установке платформы

    Пример вывода программы установки:

    space_cloud_install_2.png

  4. Программа установки выведет сообщение «Выберите существующую установку для обновления или создайте новую установку».

    Необходимо выбрать либо предложенный путь к существующей установке, либо через опцию «Указать путь к существующей установке для обновления» указать путь вручную.

    Пример вывода программы установки 
    Выберите существующую установку для обновления или создайте новую
установку
Для навигации используйте клавиши со стрелками: ↓ ↑ → ←
? Выберите опцию:
   /opt/space_cloud [1.1]
   Новая установка
 ▸ Указать путь к существующей установке для обновления
   Отмена

  5. Необходимо подтвердить обновление платформы, установленной по указанному пути.

    Пример вывода программы установки 
    ✔ Указать путь к существующей установке для обновления
Введите путь для установки продукта: /opt/space_cloud
Подтвердите обновление платформы - (Y). Отмените обновление для
перезапуска процесса - (N)
Для навигации используйте клавиши со стрелками: ↓ ↑ → ←
? Yes/No:
 ▸ Yes
   No

Процесс обновления

После подтверждения будет запущен процесс обновления указанной установки с сохранением её параметров. В процессе обновления будут произведены следующие действия:

  • Удаление образов контейнеров старше двух предыдущих версий и загрузка новых версий.

    Процесс обновления и загрузка образов

    Пример вывода программы установки:

    ......
Начинаем обновление...
Удаление старых образов...
Удаление неиспользуемых образов...
Загрузка образов для Портала...
ad5362eb8973: Loading layer
[==================================================>]
94.52MB/94.52MB
......
Загрузка образов для API Оркестратора...
a36327189475: Loading layer
[==================================================>]
3.584kB/3.584kB
......

  • Резервное копирование и обновление файлов запуска сервисов docker-compose.yml и конфигурации предыдущей установки .env.

    Резервное копирование и обновление конфигурации

    Пример вывода программы установки:

    ......
Создание новых каталогов при необходимости...
Резервное
копирование
файла
/opt/space_cloud/docker-compose.yml
/opt/space_cloud/docker-compose.yml.bk_25September2025_113659...
Резервное
копирование
файла
/opt/space_cloud/app/.env
/opt/space_cloud/app/.env.bk_25September2025_113659...
Резервное
копирование
файла
/opt/space_cloud/orchestrator/.env
/opt/space_cloud/orchestrator/.env.bk_25September2025_113659...
Обновление docker-compose.yml...
Обновление конфигурации nginx для Оркестратора...
Обновление конфигурации .orchestrator.env для Оркестратора...
Обновление конфигурации .env для Портала...
......

  • Перезапуск контейнеров из обновлённых образов.

    Перезапуск контейнеров

    Пример вывода программы установки:

    ```
......
Остановка сервисов...
Down docker compose
......
Запуск сервисов...
Starting docker compose
......
```

Успешное обновление завершится выводом итогового результата с указанием текущей версии продукта.

Итог обновления

Пример вывода программы установки:

Started docker compose
Все сервисы запущены...

----------------------------------------------------------------------------------------------
                                        Итог обновления
----------------------------------------------------------------------------------------------
Домашний каталог платформы:                  /opt/space_cloud
URL для доступа к порталу платформы:         https://space_cloud.company.ru

Версия:                                      1.2
----------------------------------------------------------------------------------------------

Платформа успешно обновлена

Внимание

После обновления портала необходимо обновить исполнитель миграции ВМ. Процесс обновления описан в статье «Обновление исполнителя миграции ВМ».