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. Скачать Helm-чарт актуальной (latest) версии.
  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

Шаг 2: Скачивание Helm-чарта актуальной (latest) версии

  1. На компьютере с доступом в интернет скачайте свежие образы ELMA365 и загрузите их в локальный реестр образов. Подробнее читайте в статье «Загрузка образов ELMA365».
  1. Обновите список чартов в репозитории:

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

  1. Если нужно скачайте архивы чартов промежуточных минорных версий для всех шагов обновления:

helm pull elma365/elma365 --version <elma365-chart-version>

  1. Cкачайте архив актуальной версии (latest) чарта ELMA365 On-Premises

helm pull elma365/elma365

  1. Полученный архив (архивы, если есть промежуточные шагов обновления) чарта elma365-X.Y.Z.tgz скопируйте на сервер, где будет производиться обновление.
  1. На сервере где будет производиться обновление распакуем чарт или чарты elma365-X.Y.Z.tgz каждый в отдельный каталог.

mkdir /path/to/elma365-X.Y.Z.tgz
tar -xf elma365-X.Y.Z.tgz -C /path/to/elma365-X.Y.Z.tgz --strip-components=1

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

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

Cкопируйте конфигурационный файл values-elma365.yaml из каталога с чартом старой (текущей) установки ELMA365 On-Premises в каждый каталог с чартом подготовленным на шаге скачивание helm-чарта актуальной (latest) версии.

Если файл 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, где будет производиться обновление.
  1. Перенести вручную параметры приложения из конфигурационного файла values-elma365.yaml старого образца (версии до 2023.4.30) в новый конфигурационный файл.

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

Обновите приложения ELMA365 с использованием конфигурационного файла values-elma365.yaml. Если имеются промежуточные минорные версий (шагов обновления два или больше), последовательно произведите обновление на каждую промежуточную минорную версию.

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

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

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

version-update-enterprise.html database-backup-and-recovery.html