Перейти к основному контенту

Обновление Docker Compose-инсталляции

Перед началом

{{ВИДЕО}}

Обновление узла Клавдия до новой версии. Образы закреплены по digest (контрольная сумма манифеста) — это гарантирует, что вы получаете именно тот образ, который выпустил разработчик, без возможности подмены. Тег latest не используется.

update.sh обновляет только образы контейнеров (klvd-node, klvd-solr, klvd-zookeeper). Файлы .env и docker-compose.yml он не перезаписывает — ваши настройки сохраняются. См. {{ССЫЛКА:reference.env|Конфигурация: .env и docker-composecompose}}.

  1. Перейдите в папку установки (где лежит docker-compose.yml):
  cd /opt/klvd
  1. Запустите обновление:
  bash update.sh --sync

Флаг --sync скачивает свежий update.sh с сервера (с проверкой контрольной суммы), заменяет себя и перезапускается уже без --sync. Это гарантирует, что скрипт обновления актуален.

  1. Скрипт:
  • покажет переход версии (текущая → новая);
  • обновит образ klvd-node до закреплённого digest;
  • при наличии локального Solr — обновит klvd-solr и klvd-zookeeper;
  • применит миграции базы данных (автоматически при старте узла);
  • пересоздаст контейнеры;
  • проверит, что контейнеры запущены на ожидаемом digest.
  1. После завершения проверьте панель состояния: блок [Самопроверка] должен показывать ok.

{{СКРИНШОТ}}

Очистка старых образов

Чтобы после обновления удалить прежние образы и неиспользуемые тома:

bash update.sh --clear-after

Именованные тома с данными (app_data, pg_data) при этом не затрагиваются — данные не теряются.

Журнал обновления

Все действия update.sh записываются в файл update.log в папке установки (с отметками времени). Если что-то пошло не так — начните диагностику с этого файла.

  • Миграции базы данных — при старте узел сам применяет недостающие миграции схемы. Не выполняйте изменения схемы вручную.
  • Миграция compose — для существующих установок update.sh переименовывает старые имена сервисов (zookeeper → klvd-zookeeper, solr → klvd-solr) и добавляет настройки HTTPS, если их ещё нет. Идемпотентно: повторный запуск не изменяет уже обновлённую конфигурацию.
  • Миграция .env — если в .env адрес локального Solr был http://127.0.0.1:8983/solr, он меняется на https:// (Solr теперь работает по HTTPS на сертификате веб-интерфейса). Пользовательские и внешние адреса не изменяются.

Что дальше

Навигация по книге

Наверх