Обновление компонентов, установленных на одном сервере

Важно!

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

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

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

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

Запустите обновление. Скрипты запуска появятся в директории /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.38_3.9 \
        "$(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 может принимать значения v2 - для загрузки образов 2.38, или all - для загрузки образов 2.38 и 3.9
Перейдите в раздел Запуск платформы.

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

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

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

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*3.8*' --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.38_3.9

Запустите обновление. Скрипты запуска появятся в директории /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.38_3.9 \
        "$(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 может принимать значения v2 - для загрузки образов 2.38, или all - для загрузки образов 2.38 и 3.9.
Перейдите в раздел Запуск платформы.

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

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

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

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

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