04 - Build y despliegue en local

En local se levanta el sistema descrito en 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.

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.
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.
  • clase/daw/proyecto-1daw/tema04.txt
  • Última modificación: 2026/11/22 10:25
  • por cesguiro