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

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

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

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

При обновлении платформы необходимо учитывать, какой протокол обмена данными используется на сервере – HTTP или HTTPS.

При использовании HTTP:

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

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

Обновление через 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

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

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

Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
На сервере перейти в скопированную папку с дистрибутивом.
Загрузить образ обновления в память.
```
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
Перейдите в раздел Запуск платформы

Обновление версий 2.29 и 3.0 одновременно

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

Обновление через 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.30_3.1

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

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

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

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

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

Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
На сервере перейти в скопированную папку с дистрибутивом.
Загрузить образ обновления в память.
```
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

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

При использовании HTTPS:

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

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

Обновление через 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.30_3.1

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

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

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

где вместо /home/visio/visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

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

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

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

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

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

где вместо /home/visio/visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

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

Обновление версий 2.29 и 3.0 одновременно

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

Обновление через 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.30_3.1

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

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

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

где вместо /home/visio/visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

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

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

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

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

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

где вместо /home/visio/visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

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

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

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

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