Обновление компонентов, установленных на одном сервере

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

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

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

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

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

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

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

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

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

Обновление версий 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 $(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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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