ELMA365 On-Premises > ELMA365 On-Premises Enterprise / Обновление версии ELMA365 Enterprise

Обновление версии ELMA365 Enterprise

начало внимание

С 30.05.2024 заблокирован доступ из РФ к Docker Hub. Ознакомьтесь с официальным заявлением компании.

конец внимание

Чтобы обеспечить целостность при миграции данных со сменой версии ELMA365, рекомендуется обновлять каждую мажорную версию без пропусков, например, версию 2023.2.1 можно обновить до 2023.3.1.

Процесс обновления ELMA365 Enterprise состоит из трёх этапов:

  1. Определение количества шагов обновления.
  2. Копирование конфигурационного файла от текущей установленной версии.
  3. Обновление с помощью Helm в Kubernetes-кластере приложения ELMA365.

Шаг 1: Определение количества шагов обновления

  1. Определите версию установленного чарта, с помощью которого было ранее развёрнуто или обновлено приложение ELMA365:

helm show chart elma365/elma365

  1. Определите версию актуального (latest) чарта:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm search repo elma365/elma365

  1. Если установленный чарт необходимо обновить более чем на одну версию, рекомендуется последовательно устанавливать каждую мажорную версию до актуального (latest) чарта.

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

начало примера

Примеры:

  1. Версия установленного чарта 2023.5.1, версия актуального (latest) чарта 2023.6.9 — обновление производится в один этап: сразу до 2023.6.9.
  2. Версия установленного чарта 2023.3.23, версия актуального (latest) чарта 2023.6.9 — обновление производится в три этапа: 2023.3.23 > 2023.4.60 > 2023.5.31 > 2023.6.9.
  3. Версия установленного чарта 2023.11.56 версия актуального (latest) чарта 2024.4.42 — обновление производится в четыре этапа: 2023.11.56 > 2024.1.32 > 2024.2.30 > 2024.3.36 > 2024.4.42.

конец примера

Обратите внимание, если у вас установлена LTS версия, то вы можете обновить её сразу на следующую LTS версию в один этап, согласно графику жизненного цикла релизов.

Чтобы посмотреть список всех версий ELMA365, используйте следующую команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm search repo elma365/elma365 --versions

Вы также можете загрузить файл формата .tar.gz с определённой версией ELMA365 с помощью адресов, перечисленных в статье «Ссылки для скачивания дистрибутивов ELMA365».

Шаг 2: Копирование конфигурационного файла от текущей установленной версии

Скопируйте конфигурационный файл values-elma365.yaml в текущий каталог. Используйте этот файл, сохранённый на этапе установки или последнего обновления.

Если файл values-elma365.yaml был утрачен, получите параметры текущей установки ELMA365 и сохраните их в этот файл, выполнив команду:

helm get values elma365 [-n namespace] > values-elma365.yaml

Обратите внимание, с версии 2023.4.30 обновилась структура конфигурационного файла values-elma365.yaml.

Если вы обновляете с 2023.4.0-21 или с более ранних версий на 2023.4.30 или более новые версии, нужно:

  1. Получить обновлённый конфигурационный файл values-elma365.yaml, выполнив команду.

helm show values elma365/elma365 > values-elma365.yaml

  1. Перенести вручную параметры приложения из конфигурационного файла values-elma365.yaml старого образца (версии до 2023.4.30) в новый конфигурационный файл.

Шаг 3: Обновление с помощью Helm в Kubernetes-кластере приложения ELMA365

Выполните обновление приложения ELMA365 с использованием конфигурационного файла values-elma365.yaml. Для этого:

  1. Последовательно произведите обновление на каждую промежуточную минорную версию, если имеются промежуточные минорные версий (шагов обновления два или больше):

helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --version <elma365-chart-version> --timeout=30m --wait [-n namespace]

Обновление приложения занимает 10-30 минут на каждом шаге.

  1. Произведите обновление до актуальной (latest) версии:

helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --timeout=30m --wait [-n namespace]

Обновление приложения занимает 10-30 минут. Дождитесь обновления параметров приложения ELMA365 Enterprise.