Особенности обновления до версии 3.1
- Эдуард Столяр
- Александр Николаев
При обновлении платформы необходимо учитывать следующие особенности:
Для обновления используется один образ как для версии 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 до текущего момента. Если вам нужна история логов, удалять эти сервисы нельзя! Но обновление может занять значительное время.
Удалить всё можно следующим образом:
Остановить сервисы:
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Далее можно запустить обновление платформы.
Смотрите также
Нужна дополнительная помощь?