search string side menu

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. Изменение предустановленных значений таймаутов для миграции данных (опционально).
  4. Обновление с помощью 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: Изменение предустановленных значений таймаутов для миграции данных (опционально)

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

  1. Оцените объём данных.
  2. Откройте конфигурационный файл values-elma365.yaml и измените предустановленные параметры:
  • global.curlMigrationsMaxTime — по умолчанию установлено 3000. Увеличьте значение, например, до 18000;
  • deploy.appconfig.migrateTimeout — по умолчанию 1h. Раскомментируйте параметр и задайте новое значение, например, 3h. Значение этого параметра должно быть таким же, как и время ожидания --timeout в команде для обновления в шаге 4.
  1. Перейдите к следующему этапу обновления.

Шаг 4: Обновление с помощью 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]

Параметр --timeout определяет время ожидания на обновление данных. Он должен совпадать со значением deploy.appconfig.migrateTimeout, если на шаге 3 вы изменили его в конфигурационном файле.

При небольшом объёме данных обновление приложения занимает 10‑30 минут на каждом шаге.

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

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

Параметр --timeout определяет время ожидания на обновление данных. Он должен совпадать со значением deploy.appconfig.migrateTimeout, если на шаге 3 вы изменили его в конфигурационном файле.

При небольшом объёме данных обновление приложения занимает 10‑30 минут. Дождитесь обновления версии приложения ELMA365 Enterprise.

change-settings-enterprise.html offline-version-update-enterprise.html