Saltar al contenido principal

1. Instalación

Este documento describe el proceso para generar e instalar el paquete de instalación de LUCA BDS.

El proceso consta de dos fases principales:

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

Generación del instalador​

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

./create-installer.sh

El script muestra un menú con las siguientes opciones:

OpciónDescripción
1. Descargar imagen de un registry privadoDescarga las imágenes del repositorio privado de LUCA.
2. Descargar imagen de Docker HubDescarga imágenes adicionales necesarias (ej. mariadb, seaweed, etc.).
3. Descargar los binarios de DockerDescarga los binarios de Docker para instalaciones en máquinas sin Docker ni conexión a internet.
4. Descargar los binarios de Docker ComposeDescarga Docker Compose para instalaciones offline.
5. Descargar los binarios de aws y jqNecesarios para subir modelos al servicio S3 local. Solo necesarios en instalaciones sin conexión a internet.
6. Descargar modelos de IAIncluye modelos de IA para dejarlos preparados en la instalación. Requiere un servicio S3 local.
7. Empaquetar el instaladorGenera el paquete .tar.gz con todos los scripts y recursos necesarios. Permite incluir una licencia y una copia (dump) de otra base de datos de LUCA.
8. SalirFinaliza el script.

El resultado de este proceso es un archivo:

installer.tar.gz

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

Instalación de LUCA BDS​

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

Desempaquetar el instalador​

tar -xzf installer.tar.gz -C .
chmod 775 .
cd installer

Ejecutar el script de instalación​

./install-luca-bds.sh

El script realiza los siguientes pasos.

Proceso de instalación​

Detección del sistema operativo​

El script intenta detectar automáticamente el sistema operativo. Si no puede determinarlo, solicita que se indique manualmente.

Inicialización del entorno​

Pregunta:

¿Quiere inicializar el entorno de Docker o instalar las utilidades
necesarias para cargar modelos al servicio S3? (Y/n)

Este paso se utiliza si:

  • Docker no está instalado.
  • Se necesitan aws y jq para gestionar la carga de modelos al repositorio S3.

Opcionalmente también permite:

  • Inicializar la red Docker de LUCA.
  • Crear los volúmenes necesarios.

Instalación del servicio lucadb​

Pregunta:

¿Quiere instalar el servicio lucadb? (Y/n)

Este paso se encarga de la configuración de la base de datos de LUCA.

El script:

  1. Genera un archivo init.sql
  2. Crea los esquemas:
  • luca
  • luca_accounts
  1. Crea los usuarios correspondientes con sus contraseñas y permisos.

Posteriormente pregunta si se desea añadir lucadb al docker-compose que se generará en el paso siguiente.

Instalación del servicio luca​

Pregunta:

¿Quiere instalar el servicio luca? (Y/n)

Este paso genera el docker-compose que levantará los servicios de LUCA.

Primero solicita qué servicios instalar.

Servicios base​

  • luca-proxy
  • luca-web
  • luca-api

Opcionalmente:

  • luca-accounts

Servicios adicionales​

También se puede elegir instalar:

  • luca-ai
  • luca-dispatcher

Dependiendo de los servicios seleccionados, el script solicita los valores de configuración necesarios.

Finalmente ofrece la opción de:

  • Crear el docker-compose.
  • Iniciar los servicios.

Carga de modelos de IA​

Pregunta:

¿Quiere cargar modelos de IA en el almacenamiento S3 local? (Y/n)

Este paso solo es necesario si se ha configurado un servicio S3 local para almacenar modelos.

El proceso:

  1. Solicita la configuración del S3 (si no se heredó del paso anterior).
  2. Crea el bucket de modelos si no existe.
  3. Sube los modelos de IA incluidos en el paquete.

Los modelos se cargan desde los archivos incluidos en el .tar.gz.

Resultado final​

Al finalizar el proceso:

  • Docker está configurado.
  • Los servicios de LUCA están desplegados.
  • La base de datos está inicializada.
  • Los modelos de IA están cargados (si aplica).

Para que LUCA quede operativo y se pueda utilizar, es necesario seguir los siguientes pasos:

  1. Ingrese en Keycloak como usuario administrador.
  2. Seleccione el realm al que se conecta LUCA.
  3. Seleccione la casilla Clients.
  4. Diríjase al cliente luca-bds-web e inserte en la casilla Valid Redirect URIs la URL correspondiente a LUCA (por ejemplo, https://luca.luca-bds.com/*).
  5. Diríjase al cliente luca-bds-api y marque la opción Credentials.
  6. En la casilla Client Secret pulse el botón Regenerate y copie el nuevo secreto.
  7. Regrese a la terminal y ejecute el comando sudo nano /etc/luca/docker-compose.yml.
  8. Modifique la variable ACCOUNTS_ADMIN_CLIENTSECRET en los servicios api y dispatcher (si aplica) y pegue el secreto copiado en el paso 6.
  9. Guarde los cambios y ejecute el comando systemctl restart luca.

El sistema quedará listo para su uso.