2. Actualización

Este documento describe el proceso para generar y utilizar el paquete de actualización de LUCA BDS.

El proceso consta de dos fases principales:

1. Generación del actualizador desde una máquina con acceso al repositorio.
2. Actualización de LUCA en la máquina destino usando el paquete generado.

Generación del actualizador

Desde una terminal con acceso al repositorio de LUCA, ejecutar:

./create-updater.sh

El script muestra un menú con las siguientes opciones:

Opción	Descripción
1. Descargar imagen de un registry privado	Descarga las imágenes actualizadas desde el repositorio privado de LUCA.
2. Descargar imagen de Docker Hub	Descarga imágenes adicionales necesarias (ej. mariadb, seaweed, etc.).
3. Empaquetar el actualizador	Genera el paquete .tar.gz con todos los scripts y recursos necesarios.
4. Salir	Finaliza el script.

El resultado de este proceso es un archivo:

updater.tar.gz

Este archivo debe copiarse a la máquina donde se realizará la actualización.

Actualización de LUCA BDS

Una vez transferido el archivo updater.tar.gz a la máquina destino:

Desempaquetar el actualizador

tar -xzf updater.tar.gz -C .
chmod 775 .

Ejecutar el script de actualización

./update-luca-bds.sh

Antes de realizar cualquier acción, el script pregunta:

¿Desea detener el servicio luca? (Y/n)

Esto permite detener los contenedores antes de aplicar cambios en las imágenes o en la configuración.

Opciones del actualizador

Despueds de la pregunta inicial, el script muestra el siguiente menú:

Opción	Descripción
1. Cargar imágenes de Docker	Carga en Docker las imágenes incluidas en el paquete del actualizador.
2. Actualizar un microservicio	Permite modificar la configuración de un servicio en el docker-compose.
3. Gestionar backup de docker-compose	Permite restaurar o eliminar el backup del docker-compose.
4. Salir	Finaliza el script.

Cargar imágenes de Docker

Esta opción:

1. Toma las imágenes incluidas en el paquete del actualizador.
2. Las carga en el entorno Docker de la máquina.

Esto permite preparar el sistema para usar nuevas versiones de los servicios.

Actualizar un microservicio

Esta opción permite modificar el contenido del fichero docker-compose que contiene la configuración de LUCA.

Antes de realizar cualquier cambio:

• Se crea automáticamente un backup del fichero docker-compose.

Una vez hecho esto, se ofrecen dos funcionalidades.

Actualizar una imagen

Permite cambiar la imagen de un servicio.

Proceso:

1. Seleccionar el servicio a modificar.
2. Introducir el nuevo tag de la imagen que se desea utilizar.

El script actualiza la referencia de la imagen en el docker-compose.

Modificar variables de entorno

Permite añadir o modificar variables de entorno en un servicio.

Proceso:

1. Seleccionar el servicio a modificar.
2. Introducir el nombre de la variable de entorno.
3. Introducir el valor de la variable.

Comportamiento:

• Si la variable no existe, se añade al fichero.
• Si la variable ya existe, se mostrará su valor actual y se pedirá confirmación antes de actualizarla.

Gestión de backups de docker-compose

El actualizador permite gestionar el backup creado al modificar servicios.

Opciones disponibles:

• Restaurar backup — Restaura el fichero docker-compose al estado previo a la modificación.
• Eliminar backup — Elimina el fichero de backup generado durante la actualización.

Resultado final

Tras completar las operaciones necesarias:

• Las nuevas imágenes están cargadas en Docker.
• El fichero docker-compose ha sido actualizado si se realizaron cambios.
• Existe un backup del docker-compose en caso de modificaciones.

El sistema queda actualizado y listo para reiniciar los servicios si fuese necesario.