Обновления Sherpa AI Server#
Перед обновлением необходимо изучить Release Notes всех версий от установленной до целевой и подготовить резервную копию данных. В заметках могут быть обязательные шаги для перехода. Заметки к последнему опубликованному релизу: версия 2.5.1. На время обновления работа сервисов будет остановлена.
При переходе с 2.5.0 на 2.5.1 сначала необходимо выполнить подготовку индексов заполненной базы. Запускайте обновление только после успешной проверки индексов: без нее миграция может завершиться ошибкой.
Обновление через скрипт#
В корне действующей установки Sherpa AI Server необходимо выполнить:
sudo ./sh_scripts/update.sh
Скрипт определяет целевую версию по архиву client-files и подбирает только архивы этой версии. Он проверяет имеющиеся контрольные суммы SHA-256 и состав Docker-архивов, свободное место и нужные образы до остановки сервисов. Затем создает резервные копии конфигурации и данных, обновляет файлы и образы, выполняет миграции и проверяет запуск. Необходимо прочитать показанные версию и список действий перед подтверждением.
Если компонент не опубликован для целевой версии, скрипт сохраняет его текущий образ :latest и перед остановкой сервисов проверяет, что образ существует и совпадает с образом работающего контейнера. Это штатный частичный релиз. Архив client-files целевой версии обязателен. Если опубликованный архив не удалось загрузить или для доступного онлайн-артефакта отсутствует обязательный файл .SHA256SUM, обновление останавливается.
Для обновления без доступа к серверу перенесите в корень установки docker_aiserver_client_files_<версия>.tgz и архивы фактически опубликованных компонентов той же версии. Приложите их файлы .SHA256SUM, если они предоставлены. Перед запуском сверьте комплект с перечнем опубликованных компонентов: в офлайн-режиме скрипт не может отличить намеренно отсутствующий компонент от забытого при переносе архива. Отсутствующий ожидаемый архив нужно получить до обновления. Если у офлайн-архива нет файла .SHA256SUM, скрипт проверяет его структуру, но не может сверить SHA-256. Если файл контрольной суммы предоставлен, его значение обязано совпасть. Не смешивайте версии и не подбирайте образы по независимым адресам /latest.
Переход на внешние LLM и Embedding при обновлении#
На сервере с локальными LLM и Embedding скрипт предложит перейти на внешние сервисы. Нажмите Enter, чтобы сохранить действующий режим, или введите y для перехода. Перед остановкой контейнеров укажите URL обоих сервисов в формате http(s)://host:port, имя LLM-модели и при необходимости токен Embedding. Для отмены ввода введите 0: настройки действующей установки не изменятся.
При переходе скрипт сохраняет адреса и параметры в .env, останавливает прежние локальные контейнеры и не запрашивает их образы и архивы моделей. Дополнительные сервисы Whisper и BGE Reranker сохраняют свои профили. После обновления проверьте наличие external в COMPOSE_PROFILES файла .env и состояние контейнеров командой docker compose --profile external ps.
В разделе Модели откройте используемый экземпляр LLM. Укажите в полях «Хост», «Порт», «Схема» и «Путь к модели» значения внешнего сервиса и сохраните экземпляр. Чат использует параметры сохраненного экземпляра, поэтому одного изменения .env недостаточно. Затем проверьте ответ в Чате и индексацию тестового документа. Если соединения нет, проверьте доступность внешних адресов из сети основного сервера и журнал aiserver.
Хранение резервных копий#
По умолчанию скрипт сохраняет все резервные копии. Чтобы после успешного обновления оставить два последних полных комплекта, администратору необходимо выполнить:
sudo env SHERPA_UPDATE_BACKUPS_KEEP=2 ./sh_scripts/update.sh
Полный комплект включает копии .env, docker-compose.yml, клиентских файлов, дамп PostgreSQL и архивы Docker volumes. Если текущий дамп или архивы volumes отсутствуют, старые комплекты не удаляются. Значение должно быть положительным целым числом. В ротацию также входят резервные каталоги моделей. Комплекты, созданные до появления отметки полной копии, остаются без удаления. Параметр 0 или отсутствие переменной отключает ротацию.
Проверка результата#
После обновления администратор может выполнить полную диагностику из каталога установки:
sudo ./sh_scripts/diagnostics.sh
Код выхода 0 и сообщение Диагностика завершена без замечаний означают, что проверки контейнеров, PostgreSQL, свободного места и ответа API прошли. При коде 1 необходимо прочитать сообщение о проблемном компоненте и проверить указанные логи. Если нужно получить приглашение на запуск диагностики сразу после успешного обновления, необходимо запускать мастер с SHERPA_DIAGNOSTICS_OFFER=true. По умолчанию приглашение отключено.
После завершения необходимо убедиться, что скрипт сообщил об успешных миграциях и проверках сервисов. Дополнительно необходимо проверить состояние контейнеров и журнал приложения:
docker compose ps
docker compose logs --tail 100 aiserver
Если обновление завершилось ошибкой, необходимо сохранить его вывод и можно использовать путь восстановления и резервные копии, показанные скриптом. Не заменяйте архивы и не можно повторять миграцию вслепую. После ручного изменения .env применяйте настройки через docker compose up -d --force-recreate. docker compose restart не перечитывает переменные окружения.