====== 04 - Build y despliegue en local ====== En local se levanta el sistema descrito en [[clase:daw:si:arquitectura|el tema de arquitectura]]: nginx sirve el frontend estático y actúa como proxy inverso, reenviando las peticiones a ''/api/'' a la aplicación Spring Boot. La aplicación utiliza MariaDB y MinIO por la red interna de Docker. Solo nginx publica el puerto 80; se accede desde el navegador por ''http://localhost''. ===== 1. Preparar el frontend y el sistema ===== El navegador ejecuta JavaScript, no TypeScript. Antes de servir el frontend, el código TypeScript debe compilarse a JavaScript y dejar el resultado en el directorio que nginx sirve. El proyecto debe establecer el proceso de compilación; aquí no se indica una herramienta ni un comando porque todavía no están especificados. El script ''dev.sh'' es un ejercicio: el alumnado debe implementarlo respetando esta interfaz y comportamiento, no copiar un script ya resuelto. Debe ejecutarse desde la raíz del proyecto, donde está ''compose.yaml'', y requiere Bash, Docker y Docker Compose disponibles. ^ Servicio de Compose ^ Componente ^ | ''nginx'' | Servidor del frontend y proxy inverso; único servicio publicado al puerto 80. | | ''app'' | Aplicación Spring Boot. | | ''db'' | MariaDB. | | ''minio'' | MinIO. | ===== 2. Interfaz y comportamiento de ''dev.sh'' ===== ^ Orden ^ Parámetros ^ Comportamiento y comprobación ^ | ''./dev.sh up'' | Ninguno. | Prepara el frontend compilando TypeScript a JavaScript en el directorio servido por nginx, construye y levanta el stack local con Docker Compose. Debe comprobar que se puede abrir ''http://localhost'' y que nginx sirve el frontend. Para ejecutar la compilación, usará el proceso que establezca el proyecto; no se presupone aquí un comando concreto. | | ''./dev.sh down'' | Ninguno. | Apaga el stack de Docker Compose. Debe conservar los volúmenes de datos de MariaDB y MinIO. La comprobación se puede hacer consultando después el estado. | | ''./dev.sh status'' | Ninguno. | Informa del estado de nginx, Spring Boot (servicio ''app''), MariaDB (''db'') y MinIO (''minio''). | | ''./dev.sh logs [servicio]'' | Servicio opcional: ''nginx'', ''app'', ''db'' o ''minio''. | Sin servicio, consulta los logs de todos los componentes; con servicio, consulta solo los de ese componente. Si se indica un nombre no reconocido, muestra el uso y un error. | | ''./dev.sh help'' | Ninguno. | Muestra el uso del script, las órdenes disponibles y los servicios aceptados por ''logs''. | Para ''up'', el proceso de compilación del frontend es un requisito: hasta que el proyecto defina cómo ejecutarlo, no se debe inventar una herramienta ni afirmar que el script puede compilar TypeScript automáticamente. El resultado que sirve nginx debe ser JavaScript. El apagado normal con ''down'' conserva los volúmenes nombrados ''db-data'' y ''minio-data'', por lo que los datos persisten al volver a levantar el stack. No se debe añadir una opción que elimine los volúmenes.