Сравнение страниц

В связи с переименованием docker-сущности для 2.30 с visiology на visiology2, при обновлении происходит копирование volume с данными database-backups, loki_data, grafana_data, prometheus_data.

Если эти volume занимают много места (больше 1 Гб), то обновление может занять продолжительное время.

Посмотреть их размер можно с помощью команды docker system df -v | grep visiology

В database-backups хранятся бэкапы сервиса mongodb. Их удаление не приведет ни к каким последствиям.

В loki_data, grafana_data и prometheus_data хранится индексированная история логов и метрик. При их удалении нельзя будет посмотреть историю логов в Grafana до текущего момента. Если вам нужна история логов, удалять эти сервисы нельзя! Но обновление может занять значительное время.

Удалить всё можно следующим образом:

Остановить сервисы:

Информация

Блок кода
docker service scale visiology_admin=0 && \ docker service scale visiology_loki=0 && \ docker service scale visiology_grafana=0 && \ docker service scale visiology_prometheus=0

Удалить volume с помощью следующей команды:
docker volume rm visiology_database-backups visiology_loki_data visiology_grafana_data visiology_prometheus_data

Далее можно запустить обновление платформы панель

panelIconId	atlassian-warning
panelIcon	:warning:
bgColor	#FFEBE6

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

Примечание

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

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

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

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

Раскрыть

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

Примечание

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

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

Войдите в Yandex Container Registry:
Блок кода
language bash
docker login \ --username oauth \ --password <token> \ cr.yandex
где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb
Установите образ обновления:
Блок кода
language bash
docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
Создать новую папку и перейти в неё. Скрипты запуска появятся в ней.

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

Блок кода

language	bash

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/visiology \
    -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

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

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

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

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

Блок кода

language	bash

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/visiology \
    -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

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

Раскрыть

title	Обновление версий 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
Установите образ обновления:
Блок кода
language bash
docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
Создать новую папку и перейти в неё. Скрипты запуска появятся в ней.

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

Блок кода

language	bash

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/visiology \
    -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

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

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

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

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

Блок кода

language	bash

docker run -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /docker-volume:/docker-volume \
    -v /var/lib/visiology:/mnt/visiology \
    -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

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

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

Раскрыть

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

Примечание

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

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

Войдите в Yandex Container Registry:
Блок кода
language bash
docker login \ --username oauth \ --password <token> \ cr.yandex
где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb
Установите образ обновления:
Блок кода
language bash
docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
Создать новую папку и перейти в неё. Скрипты запуска появятся в ней.

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

Блок кода

language	bash

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, выполнив команду:
Блок кода
language bash
sudo chmod +x *.sh
Загрузить образ обновления в память.
Блок кода
language bash
docker load < update.tar.gz

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

Блок кода

language	bash

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. Перейдите в раздел Запуск платформы

Раскрыть

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

Примечание

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

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

Войдите в Yandex Container Registry:
Блок кода
language bash
docker login \ --username oauth \ --password <token> \ cr.yandex
где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb
Установите образ обновления:
Блок кода
language bash
docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
Создать новую папку и перейти в неё. Скрипты запуска появятся в ней.

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

Блок кода

language	bash

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. Перейдите в раздел Запуск платформы

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

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

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

Блок кода

language	bash

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.

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

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

Сравнение версий

Старая версия 12

Новая версия 13

Ключ

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

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

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

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

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

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

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

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