На этой странице

Резервные копии, восстановление и обновление

Копия установки быстрого старта

В репозитории запущенной версии приостановите внешних производителей задач и дождитесь окончания работы раздельных пулов. На время копирования установка недоступна. Скрипту поставки нужен один свободный воркер, который отвечает на запросы. Укажите имя запущенного проекта и путь к каталогу, которого ещё нет.

./scripts/distribution.sh backup contextbase /absolute/path/to/new-backup

Дождитесь маркера COMPLETE. В копии будут сведения об образах, контрольные суммы, дамп PostgreSQL в формате custom и архивы остановленных томов конфигурации, исходных файлов и Redis. Скрипт останавливает производителей и свободный воркер. Если остановка производителей прошла успешно, после попытки копирования скрипт пробует запустить сервисы.

Для конфигурации с дополнительным слоем передайте его абсолютный путь в CONTEXTBASE_COMPOSE_OVERRIDE и сохраните файл вместе с настройками установки. Для другой топологии отдельно предусмотрите восстановление базы, объектного хранилища и внешних сервисов.

Определите состав резервной копии

Храните вместе дамп PostgreSQL, исходные файлы и ключи шифрования конфигурации. Запишите версию, идентификаторы образов и слои Compose. Учтите сохранение данных Redis и внешние векторные базы, объектные хранилища, службы идентификации и настройки провайдеров. Архивы локальных томов охватывают данные только этого сервера.

Ограничьте доступ к копии и храните её в независимом хранилище. Перед обновлением проверьте восстановление и рабочий сценарий.

Проверьте восстановление

Выберите новое имя проекта и свободный порт. Сначала возьмите сохранённую версию исходников и подходящие образы приложения. Сохраните параметры хранилищ и выберите слой Compose для изолированной проверки.

CONTEXTBASE_UI_PORT=13002 ./scripts/distribution.sh restore \
  contextbase-restored /absolute/path/to/new-backup

Скрипт проверяет маркер завершения и контрольные суммы. Для нового проекта не должно существовать контейнеров, сетей или томов. При восстановлении скрипт возвращает файлы и ключи, инициализирует PostgreSQL, загружает копию базы и запускает приложение с шагом миграции. Если процедура завершилась с ошибкой, изучите состояние изолированного проекта и после устранения причины используйте другое свободное имя.

Проверьте следующие действия на восстановленной установке.

  1. Войдите с существующей учётной записью и откройте её пространство.

  2. Скачайте исходный документ и сравните его с ожидаемым файлом.

  3. Найдите проиндексированный документ и откройте источник найденного фрагмента.

  4. Проверьте сохранённую зашифрованную настройку, если она используется.

Кеш моделей и собранные статические файлы можно восстановить отдельно. После восстановления заложите время на скачивание весов или прогрев.

Безопасное обновление

Для установки через опубликованный локальный установщик следуйте инструкции обновления. Установщик загружает образы нового выпуска до остановки и сохраняет проект и тома. Сначала создайте резервную копию. Изменения конфигурации инициализации хранилищ или другие несовместимые параметры Compose требуют отдельного переноса.

Для совместимых образов, собранных из исходников, используйте release.env из проверенной поставки. Выполните из каталога соответствующей версии.

set -a
. /absolute/path/to/new-release-manifest/release.env
set +a
./scripts/distribution.sh upgrade contextbase /absolute/path/to/pre-upgrade-backup

Сохраните прежние образы и исходники. Скрипт проверяет идентификаторы и платформу образов, делает копию до обновления и запускает миграции. Перед возвратом нагрузки проверьте вход, поиск и фоновую обработку. Если завершить обновление не удаётся, восстановите предобновленческую копию в новом проекте на прежней версии. Простой запуск старого образа с изменённой БД не выполняет откат схемы.

ContextBase0.1.0

Поиск в документации