Actualizaciones de Sherpa AI Server#

Antes de actualizar, consulte las notas de todas las versiones desde la instalada hasta la de destino y prepare una copia de seguridad de los datos. Las notas pueden incluir pasos obligatorios para la actualización. Notas de la última versión publicada: versión 2.5.1. Los servicios se detendrán temporalmente durante la actualización.

Al actualizar de 2.5.0 a 2.5.1, primero prepare los índices de la base de datos con información. Ejecute la actualización solo después de comprobar correctamente los índices. De lo contrario, la migración puede fallar.

Actualización mediante el script#

Desde la raíz de la instalación actual de Sherpa AI Server, ejecute:

sudo ./sh_scripts/update.sh

El script determina la versión de destino a partir del archivo client-files y selecciona únicamente los archivos de esa versión. Antes de detener los servicios, comprueba las sumas SHA-256 disponibles y los manifiestos de los archivos Docker, el espacio libre y las imágenes necesarias. Después crea copias de seguridad de la configuración y los datos, actualiza archivos e imágenes, ejecuta las migraciones y comprueba el inicio. Es necesario revisar la versión y la lista de acciones mostradas antes de confirmar.

Cuando un componente no se publica para la versión de destino, el script conserva su imagen actual :latest y comprueba, antes de detener los servicios, que la imagen existe y coincide con la del contenedor en ejecución. Se trata de una versión parcial prevista. El archivo client-files de la versión de destino siempre es obligatorio. Si no se puede descargar un archivo publicado o falta el archivo .SHA256SUM obligatorio de un artefacto disponible en línea, la actualización se detiene.

Para actualizar sin conexión al servidor, copie a la raíz de la instalación docker_aiserver_client_files_<versión>.tgz y los archivos de los componentes publicados realmente para la misma versión. Incluya sus archivos .SHA256SUM cuando estén disponibles. Antes de ejecutar el script, compare el conjunto con la lista de componentes publicados: sin conexión, el script no puede distinguir un componente omitido intencionadamente de un archivo olvidado durante la transferencia. Obtenga cualquier archivo publicado que falte antes de actualizar. Si un archivo sin conexión no tiene .SHA256SUM, el script comprueba su estructura, pero no puede verificar su SHA-256. Cualquier suma de control incluida debe coincidir. No mezcle versiones ni seleccione imágenes desde endpoints /latest independientes.

Cambiar a LLM y Embedding externos durante una actualización#

En un servidor con LLM y Embedding locales, el script ofrece cambiar a servicios externos. Pulse Enter para conservar el modo actual o introduzca y para cambiar. Antes de detener los contenedores, indique las URL de ambos servicios con el formato http(s)://host:port, el nombre del modelo LLM y, si corresponde, el token de Embedding. Introduzca 0 para cancelar la entrada; la configuración de la instalación activa no cambiará.

Al cambiar, el script guarda las direcciones y los parámetros en .env, detiene los contenedores locales anteriores y no solicita sus imágenes ni los archivos de modelos. Se conservan los perfiles opcionales de Whisper y BGE Reranker. Después de actualizar, compruebe que COMPOSE_PROFILES en .env contiene external y el estado de los contenedores con docker compose --profile external ps.

En la sección Modelos, abra la instancia LLM utilizada. Indique los valores del servicio externo en los campos «Host», «Puerto», «Esquema» y «Ruta del modelo», y guarde la instancia. Chat usa la configuración guardada de la instancia, por lo que no basta con cambiar .env. Compruebe una respuesta en Chat e indexe un documento de prueba. Si falla la conexión, compruebe el acceso a las direcciones externas desde el servidor principal y consulte los registros de aiserver.

Conservación de copias de seguridad#

De forma predeterminada, el script conserva todas las copias de seguridad. Para conservar los dos conjuntos completos más recientes después de una actualización correcta, el administrador debe ejecutar:

sudo env SHERPA_UPDATE_BACKUPS_KEEP=2 ./sh_scripts/update.sh

Un conjunto completo incluye copias de .env, docker-compose.yml, los archivos del cliente, un volcado de PostgreSQL y los archivos de los volúmenes de Docker. Si faltan el volcado o los archivos de los volúmenes de la actualización actual, no se eliminan los conjuntos anteriores. El valor debe ser un entero positivo. La rotación también incluye los directorios de copia de los modelos. Los conjuntos creados antes de incorporar la marca de copia completa permanecen intactos. El valor 0 o la ausencia de la variable desactiva la rotación.

Comprobación del resultado#

Después de la actualización, el administrador puede ejecutar el diagnóstico completo desde el directorio de instalación:

sudo ./sh_scripts/diagnostics.sh

El código de salida 0 y el mensaje Диагностика завершена без замечаний indican que las comprobaciones de contenedores, PostgreSQL, espacio libre y respuesta de la API se completaron correctamente. Si el código es 1, consulte el componente afectado en el mensaje y revise los registros indicados. Para recibir una pregunta sobre el diagnóstico después de una actualización correcta, inicie el asistente con SHERPA_DIAGNOSTICS_OFFER=true. De forma predeterminada está desactivada.

Al terminar, confirme que el script informa de migraciones y comprobaciones de servicios correctas. Es necesario revisar también los contenedores y el registro de la aplicación:

docker compose ps
docker compose logs --tail 100 aiserver

Si la actualización falla, conserve su salida y utilice las instrucciones de recuperación y las copias de seguridad indicadas por el script. No sustituya archivos ni repita migraciones a ciegas. Después de modificar .env manualmente, aplique los ajustes con docker compose up -d --force-recreate; docker compose restart no vuelve a cargar las variables de entorno.