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

Информация

В связи с переименованием 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
Далее можно запустить обновление платформы.

Примечание

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

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

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

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

Раскрыть

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

панель

panelIconId	atlassian-warning
panelIcon	:warning:
bgColor	#FFEBE6

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

Примечание

Если предполагается обновление платформы, используя 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

Перейти в папку с дистрибутивами и запустить

Запустите обновление. Скрипты запуска появятся в

текущей директории

директории /var/lib/visiology/scripts.

Блок кода

language	bash

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/

visiology

volume \ -v

$(pwd):

/

mnt/volume \ -v $HOME/.docker:/root/.docker

home/visio/2.31+3.2:/mnt/old-scripts \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.

30

32_3.

1

3 \

-l

local

$(pwd) \

"$(id -u)

:$(cut -d

:

-f3 < <(getent group

$(id -

gn

g)

))

" | \
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

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

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

где в 6 строке нужно заменить /home/visio/2.31+3.2 на ваш путь к каталогу со скриптами запуска предыдущего релиза.
Запустите скриптload_images.sh для загрузки образов нового релиза:
Блок кода
language bash
/var/lib/visiology/scripts/load_images.sh --version <VERSION> -i <path_to_distrib>/images
где path_to_distrib - абсолютный путь к дистрибутиву платформы.
VERSION может принимать значения v3 - для загрузки образов 3.3, или all - для загрузки образов 2.32 и 3.3
Перейдите в раздел Запуск платформы .
Опционально выполните удаление образов от старой версии:
Блок кода
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 \

rmi $(docker images --filter=reference='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

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

2' --format "{{ .Repository }}:{{ .Tag }}")
Для удаления образов 2.31 и 2.31.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 \

rmi $(docker images --filter=reference='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.

Обновление

31*' --format "{{ .Repository }}:{{ .Tag }}")

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

32_3.

1Создать новую папку и перейти в неё

3
Запустите обновление. Скрипты запуска появятся в

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

директории /var/lib/visiology/scripts.

Блок кода

language	bash

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/

visiology

volume \ -v /home/visio/

visio3.0/visiology-certs

2.31+3.2:/mnt/

certs \ -v $(pwd):/mnt/volume

old-scripts \

-v $HOME/.docker:/root/.docker \

cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.

30

32_3.

1

3 \

-l

hub $(pwd)

\

"$(id -u):$(

cut -d: -f3 < <(getent group $(

id -

gn

g)

))

" | \
tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

где

вместо

в 6 строке нужно заменить /home/visio/

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

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

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

Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

На сервере перейти в скопированную папку с дистрибутивом.

Сделать исполняемыми скрипты load_images.sh,

2.31+3.2 на ваш путь к каталогу со скриптами запуска предыдущего релиза.
Запустите скрипт 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

scripts/load_from_release_dockerhub.sh --version <VERSION>
где VERSION может принимать значения v3 - для загрузки образов 3.3, или all - для загрузки образов 2.32 и 3.3.
Перейдите в раздел Запуск платформы .
Опционально выполните удаление образов от старой версии:
Блок кода
language bash
docker

login

rmi

\

$(docker images

--username oauth \ --password <token> \ cr.yandex

где <token> - токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

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

Блок кода

language	bash

docker pull

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

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

Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

На сервере перейти в скопированную папку с дистрибутивом.

Загрузить образ обновления в память.

*3.2' --format "{{ .Repository }}:{{ .Tag }}")
Для удаления образов 2.31 и 2.31.1 выполните следующую команду:
Блок кода
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 \

rmi $(docker images --filter=reference='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

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

31*' --format "{{ .Repository }}:{{ .Tag }}")

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

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

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

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

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

Новая версия Текущий

Ключ

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

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

образы

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

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

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

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

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

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