Обновление платформы

Важно!

Перед обновлением платформы прочтите, пожалуйста, раздел Особенности обновления до версии 3.8.
Перед обновлением платформы убедитесь, что она запущена. Если запущены обе версии платформы (2 и 3), то обновятся обе версии. Если запущена одна версия, то обновится только эта версия. Вторая версия не будет обновлена.

Если предполагается обновление платформы, используя Yandex Container Registry, то копирование файлов дистрибутива не требуется.
Перед обновлением важно убедиться, что у пользователя, из-под которого будет происходить обновление, есть все права на выполнение команды docker.
Если одна из предыдущих версий платформы обновлялась, а другая нет, рекомендуется удалить платформу полностью и заново установить ее.

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

Получить файл secrets.txt с паролями можно следующей командой.

for name in mongodb clickhouse keycloak minio data-management-service; do
  container_id=$(docker ps | grep visiology3_${name} |  awk '{ print $1 }'); \
  docker exec ${container_id} ls /run/secrets | \
  xargs -I {} docker exec -i ${container_id} sh -c 'echo -n "{}: "; cat /run/secrets/{}; echo ""' >> secrets.txt
done

Обновление через образы

Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
На сервере перейдите в скопированную папку с дистрибутивом.
Загрузите образ обновления в память:
```
docker load < update.tar.gz
```

Запустите образ обновления для получения новых скриптов загрузки образов:

docker run --rm -it \
    --name update-container \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.37_3.8 \
       --only-extract-load-scripts "$(id -u):$(id -g)" | \
tee /var/lib/visiology/logs/update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

Запустите скрипт load_images.sh для загрузки образов нового релиза:
```
/var/lib/visiology/scripts/load_images.sh --version <VERSION> -i <path_to_distrib>/images
```
где path_to_distrib - абсолютный путь к дистрибутиву платформы.
VERSION может принимать значения v3 - для загрузки образов 3.8, или all - для загрузки образов 2.37 и 3.8

Запустите обновление. Скрипты запуска появятся в директории /var/lib/visiology/scripts.

docker run --rm -it \
    --name update-container \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.37_3.8 \
        "$(id -u):$(id -g)" | \
tee /var/lib/visiology/logs/update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

Перейдите в раздел Запуск платформы .

Опционально выполните удаление образов версии 3.7:

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*3.7*' --format "{{ .Repository }}:{{ .Tag }}")

Для удаления образов 2.36 выполните следующую команду:

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*2.36*' --format "{{ .Repository }}:{{ .Tag }}")

Обновление через Yandex Container Registry

Войдите в Yandex Container Registry:
```
docker login \
   --username oauth \
   --password <token> \
   cr.yandex 
```
где <token> - токен, предоставленный отделом поддержки по вашему запросу.

Установите образ обновления:

docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.37_3.8

Запустите образ обновления для получения новых скриптов загрузки образов:

docker run --rm -it \
    --name update-container \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.37_3.8 \
       --only-extract-load-scripts "$(id -u):$(id -g)" | \
tee /var/lib/visiology/logs/update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

Запустите скрипт load_from_release_dockerhub.shдля загрузки образов нового релиза:
```
/var/lib/visiology/scripts/load_from_release_dockerhub.sh --version <VERSION>
```
где VERSION может принимать значения v3 - для загрузки образов 3.8, или all - для загрузки образов 2.37 и 3.8.

Запустите обновление. Скрипты запуска появятся в директории /var/lib/visiology/scripts.

docker run --rm -it \
    --name update-container \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.37_3.8 \
        "$(id -u):$(id -g)" | \
tee /var/lib/visiology/logs/update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

Перейдите в раздел Запуск платформы .

Опционально выполните удаление образов версии 3.7:

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*3.7*' --format "{{ .Repository }}:{{ .Tag }}")

Для удаления образов 2.36 выполните следующую команду:

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*2.36*' --format "{{ .Repository }}:{{ .Tag }}")

При возникновении неполадок, см. Возможные неполадки и пути их устранения в разделе Работа по HTTPS.

Вы можете получить информацию о версии и сборке каждого компонента платформы, введя следующую строку в интернет-браузере:
<domain>/v3/version
где <domain> – доменное имя или IP-адрес сервера. Результатом будет список компонентов платформы с указанием номера версии, сборки и другой дополнительной информации:

Нужна дополнительная помощь?

Свяжитесь с технической поддержкой.