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

Важно! Перед обновлением платформы прочтите, пожалуйста, раздел Особенности обновления до версии 3.2.

При обновлении с версии 3.1 будут удалены все пользователи в Keycloak и создастся пользователь по умолчанию:

логин: admin
пароль: 123456

Обновление версии 3.1

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

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

Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
На сервере перейдите в скопированную папку с дистрибутивом.
Загрузите образ обновления в память.
```
docker load < update.tar.gz
```
Перейдите в папку с дистрибутивами и запустите обновление. Скрипты запуска появятся в текущей директории.
```
docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v $(pwd):/mnt/volume \
    -v $HOME/.docker:/root/.docker \
    -v /home/visio/2.30+3.1:/mnt/old-scripts \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2 \
    -l local \
    -m all \
    -v v3 \
    $(pwd) $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
```
где в 6 строке нужно заменить /home/visio/3.1 на ваш путь к каталогу с предыдущими скриптами 3.1 и
в 10 строке выбрать, на какую версию необходимо обновить: -v v3 - обновит на версию 3.2, -v all - обновит на версии 2.31 и 3.2
Перейдите в раздел Запуск платформы

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

Войдите в Yandex Container Registry:
```
docker login \
   --username oauth \
   --password <token> \
   cr.yandex 
```
где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

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

docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2

Создайте новую папку и перейдите в неё. Скрипты запуска появятся в ней.

Запустите обновление.

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v $(pwd):/mnt/volume \
    -v $HOME/.docker:/root/.docker \
    -v /home/visio/3.1:/mnt/old-scripts \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2 \
    -l hub \
    -m all \
    -v v3 \
    $(pwd) $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

где в 6 строке нужно заменить /home/visio/3.1 на ваш путь к каталогу с предыдущими скриптами 3.1 и
в 10 строке выбрать, на какую версию необходимо обновить: -v v3 - обновит на версию 3.2, -v all - обновит на версии 2.31 и 3.2

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

Обновление версий 2.30 и 3.1 одновременно

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

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

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

Перейдите в папку с дистрибутивами и запустите обновление. Скрипты запуска появятся в текущей директории.

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v $(pwd):/mnt/volume \
    -v $HOME/.docker:/root/.docker \
    -v /home/visio/2.30+3.1:/mnt/old-scripts \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2 \
    -l local \
    -m all \
    -v all \
    $(pwd) $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

где в 6 строке нужно заменить /home/visio/2.30+3.1 на ваш путь к каталогу с предыдущими скриптами 2.30 и 3.1

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

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

Войдите в Yandex Container Registry:
```
docker login \
   --username oauth \
   --password <token> \
   cr.yandex 
```
где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

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

docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2

Создайте новую папку и перейдите в неё. Скрипты запуска появятся в ней.

Запустите обновление.

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v $(pwd):/mnt/volume \
    -v $HOME/.docker:/root/.docker \
    -v /home/visio/2.30+3.1:/mnt/old-scripts \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2 \
    -l hub \
    -m all \
    -v all \
    $(pwd) $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

где в 6 строке нужно заменить /home/visio/2.30+3.1 на ваш путь к каталогу с предыдущими скриптами 2.30 и 3.1

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

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

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

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