Обновление ПО Витрина данных

Процесс обновления ПО Витрина возможно различными путями, в зависимости от первоначальной установки.

  1.   ПО Витрина Лайт (процесс обновления ПО Витрина Лайт описан в статье – Обновление витрины данных Лайт).
  2.   ПО Витрина Стандарт (обновление происходит двумя путями):

• Без оркестратора;
• Через оркестратор (Datamart Studio).

Обновление ПО Витрина Стандарт без оркестратора

Для обновления ПО «Витрина данных» версии Стандарт нужно обновить jar-файлы приложений, полученные из дистрибутива новой версии программы. При этом все настройки программы (адреса серверов, порты и т.д.) останутся без изменений.

Процесс загрузки jar-файлов на сервер описан в Руководстве по установке Типового ПО Витрина, размещённом на портале ЕСКС в разделе  "ПО для Участников СМЭВ".

  Примечание

Когда речь идёт о обновлении витрины, необходимо понимать, что потребуется обновить совокупность компонентов. Сам процесс обновления должен происходить с учетом особенности конкретной Витрины данных и последовательности установки приложений в ней

Рассмотрим, как происходит процесс обновления на примере приложения podd-agent, если приложение было развёрнуто в контейнере docker:

          1)     Для начала загрузите новый образ в докер. Пример команды ниже:

docker pull einfahrt/podd-agent-3.14.1:latest

          2)     Остановите и удалите текущий контейнер приложения:

docker stop podd-agent-3.12.0 docker rm podd-agent-3.12.0

          3)     На основе образа запустите контейнер с новым приложением:

docker run podd-agent-3.14.1

Обновление ПО Витрина Стандарт через оркестратор

Процесс обновления витрины через оркестратор является наиболее удобным путем обновления, так как встроенные инструменты автоматизируют процесс управления, что позволяет исключить ручную отладку напрямую на сервере. Также существует возможность отслеживания возникающих проблем посредством встроенного мониторинга ошибок.

Обновление ПО «Витрины данных» в Datamart Studio производится в несколько шагов:

  1.   Сначала необходимо обновить репозиторий;
  2.   При необходимости, обновить конкретные бандлы приложений;
  3.   Затем обновляются нужные инсталляции (компоненты) Витрины данных.

Обновление репозитория

Для начала необходимо обновить хранилище репозиториев локального Gitea. Для этого на левой панели Datamart Studio необходимо выбрать вкладку Репозитории и перейти в Локальный Gitea:

Рисунок 1 – Datamart Studio. Хранилище репозиториев

  Примечание

 В процессе обновления из репозитория происходит обновления бандлов приложений в Datamart Studio. Инсталляции витрины при этом не меняются

В открывшейся карточке хранилища репозиториев необходимо нажать на «Обновить»:

Рисунок 2 – Datamart Studio. Локальный Gitea

Если есть необходимость обновить конкретный бандл приложения - можно сделать это точечно, перейдя на вкладку бандла или приложения, выбрать из перечня нужный и нажать на «Обновить»:

Рисунок 3 – Datamart Studio. Обновление приложения

Подробнее о видах обновлений бандлов приложений описано в документации Datamart Studio в подразделе Обновление бандлов приложений.

При обновлении приложений из бандлов происходит скачивание файлов бандлов из репозитория бандла. По умолчанию, используется ветка с последней версией бандла, при необходимости пользователь может выбрать требуемую ветку или тэг для обновления, если по каким-то причинам требуется использовать для обновления специфическую версию бандла, а не последнюю актуальную – подробнее описано в документации Datamart Studio в подразделе Выбор версии бандла для обновления.

После того, как обновили репозиторий, появятся новые бандлы приложений для установки. Можно обратить внимание, что в карточке Витрины данных появилась надпись – Есть обновление:

Рисунок 4 – Datamart Studio. Обновление Витрины данных

Обновление инсталляции происходит в несколько шагов:

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

Рисунок 5 – Datamart Studio. Обновление инсталляции csv_uploader

  Примечание

 С помощью данной команды можно «повысить» или «понизить» версию инсталлированного в витрину (услугу) приложения

В открывшемся окне нужно выбрать новую версию приложения для обновления необходимой инсталляции:

Рисунок 6 – Datamart Studio. Выбор версии приложения для инсталляции csv_uploader

Существует также возможность принудительного обновления приложения:

Рисунок 7 – Datamart Studio. Опция принудительного обновления

Данная опция (выкл. по умолчанию) влияет на обновление настроек приложения следующим образом:

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

          2)     После изменения версии инсталляции приложения потребуется обновить настройки, параметры и связи интерфейсов (если в новой версии они изменились и требуют корректировки). Также необходимо произвести требуемые корректировки (настроек, связей или файлов), действия зависят от типа и версии обновляемого приложения.

          3)     Для применения произведенного обновления к инсталляции приложения на сервере при смене версии приложения выберите в меню управления опцию «Установить». Если версия приложения не менялась, достаточно выполнить действие «Применить конфигурацию (bind)».

  Примечание

 При выполнении действия «Установить» будет удален docker-контейнер со старым приложением и создан новый с новой версией

Подробнее про обновление инсталляций описано в документации Datamart Studio в подразделе Обновление инсталляций.

Для обновления приложений, работающих в кластере, в меню управления кластером необходимо выбрать действие Обновить приложения. При обновлении приложений кластера нельзя изменить версию приложений. Доступно только применение изменений текущих версий при обновлении бандлов.

Процесс добавления и удаления инсталляций приложений в рабочем кластере см. в разделах Раздел 10.4.1 Добавление инсталляций в работающий кластер, Раздел 10.4.2 Удаление инсталляций из работающего кластера официальной документации Datamart Studio.

Проверка версии приложения после обновления

Чтобы проверить версию того или иного приложения в ПО «Витрина данных» версии Стандарт, необходимо перейти в env docker-контейнера интересующего приложения. Пример команды ниже:

docker exec podd-adapter-query env

В ответе отобразится содержимое системного файла env с настройками и версией приложения:

Рисунок 8 – Env приложения podd-adapter-query

Есть ещё один способ проверки версии приложения podd-adapter-query из консоли. Для этого необходимо перейти на ВМ с установленным приложением и отправить следующий запрос:

curl -s http://localhost:8083/version

Рисунок 9 – Запрос на просмотр версии приложения podd-adapter-query

Версию Prostore можно также просмотреть, настроив jdbc-драйвер на работу с БД витрины.

Для настройки jdbc-драйвера воспользуйтесь статьёй - Как найти причину ошибки обмена СМЭВ4? (см. раздел: Рекомендации для Поставщиков данных -> Настройка jdbc-драйвера).

Для этого необходимо запустить команду check_versions:

check_versions();

Рисунок 10 – Просмотр версии простора через jdbc-драйвер в ПО DBeaver

Версию Агента СМЭВ4 можно проверить запросом:

curl -X GET http://localhost:8192/api/v1/agent-info/version

Рисунок 11 – Просмотр версии Агента СМЭВ4