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

Важно!

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

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

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

/var/lib/visiology/scripts/v3/utils/store_secrets -f <file>
где <file> - название файла, куда будут сохранены секреты.

Загрузить полученные секреты можно с помощью скрипта из дистрибутива: /var/lib/visiology/scripts/v3/utils/load_secrets.sh -f <file>

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

Скачайте дистрибутив платформы и распакуйте его на сервере.
На сервере перейдите в скопированную папку с дистрибутивом.
Загрузите образ обновления в память:
```
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.41_3.12 \
        "$(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.12, или all - для загрузки образов 2.41 и 3.12
Перейдите в раздел Запуск платформы .

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

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*3.11*' --format "{{ .Repository }}:{{ .Tag }}") &&
docker rmi cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/original/clickhouse-{server,keeper}:24.8.6.70-alpine

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

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

Запустите обновление. Скрипты запуска появятся в директории /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.41_3.12 \
        "$(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.12, или all - для загрузки образов 2.41 и 3.12.
Перейдите в раздел Запуск платформы .

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

docker rmi $(docker images --filter=reference='cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/*3.11*' --format "{{ .Repository }}:{{ .Tag }}") &&
docker rmi cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/original/clickhouse-{server,keeper}:24.8.6.70-alpine

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

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

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

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

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

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