Особенности обновления до версии 3.1

Owned by Эдуард Столяр
Last updated: февр. 02, 2023
2 min read

При обновлении платформы необходимо учитывать следующие особенности:

  • Для обновления используется один образ как для версии 2.29, так и для версии 3.0:
    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

     

  • При обновлении до версии 3.1 все пользователи исчезнут. Их нужно будет создать заново.

Изменения в механизме запуска платформы

  • Вместо Docker Compose 1.29.2 теперь используется Docker Compose 2.10.2 (или более поздняя версия).

  • Появились prepare-скрипты, которые настраивают окружение. Скрипт run.sh, который запускает платформу, использует уже настроенное окружение.

  • Используется единый run.sh-скрипт как для запуска версии 2.30, так и для запуска версии 3.1.

  • Используется новый компонент reverse-proxy для маршрутизации запросов между версиями 2.30 и 3.1.

  • Файлы SSL-сертификатов переносятся в папку /var/lib/visiology/certs.

  • Во всех скриптах теперь используются унифицированные аргументы команд: true/false, вместо yes/no и on/off.

  • Изменилась Docker-сеть для версии 2. Теперь используется visiology_visiology-2 вместо visiology_default.

  • Изменилось название Docker Stack для версии 2 (отражается на именах Docker контейнеров и сервисов): теперь используется visiology2 вместо visiology.

  • Скрипты поставляются в контейнере для версии 2.30 (скрипты общие для версии 2.30, и для версии 3.1):
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:2.30_3.1

  • Тэги образов теперь используются явно. Тэг latest более не используется.

В связи с переименованием 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 до текущего момента. Если вам нужна история логов, удалять эти сервисы нельзя! Но обновление может занять значительное время.

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

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

    docker service scale visiology_admin=0 && \ docker service scale visiology_loki=0 && \ docker service scale visiology_grafana=0 && \ docker service scale visiology_prometheus=0

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

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

Смотрите также

Обновление платформы
Запуск платформы

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

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