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

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

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

  • {{ССЫЛКА:maintenance.backup-overview|Что необходимо резервировать}}

{{ВИДЕО}}

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

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

  1. Перейдите в папку установки (где лежит docker-compose.yml):

    cd /opt/klvd

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

    bash update.sh --sync

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

  3. Скрипт:

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

  4. После завершения проверьте панель состояния: блок [Самопроверка] должен показывать 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 на сертификате веб-интерфейса). Кастомные и внешние адреса не трогаются.

Что дальше

  • {{ССЫЛКА:maintenance.update-check|Проверка после обновления}}

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

  • Следующая статья: {{ССЫЛКА:maintenance.update-multinode|Обновление многоузлового кластера Docker Compose}}
Наверх