08 - Arquitectura de aplicación

Hasta aquí, cada servidor se ha arrancado por su lado: un Tomcat, un MinIO, una base de datos. Una aplicación real es un sistema de varios servidores que colaboran. Docker Compose (tema 02) permite describir ese sistema completo en un compose.yaml y arrancarlo de una vez.

La arquitectura de referencia de una aplicación web clásica:

• nginx es el punto de entrada único: sirve el frontend estático (HTML, CSS, JS) y actúa de reverse proxy: reenvía las rutas de la API a la aplicación.
• App (Tomcat): la API REST en Java; no publica puerto propio, solo responde al proxy.
• MariaDB: la persistencia relacional.
• MinIO: el almacenamiento de objetos para los ficheros.

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
      - ./frontend:/usr/share/nginx/html:ro
    depends_on:
      - app

  app:
    build: ./app
    environment:
      DB_URL: jdbc:mariadb://db:3306/miapp
      S3_ENDPOINT: http://minio:9000
    depends_on:
      - db
      - minio

  db:
    image: mariadb:11
    environment:
      MARIADB_ROOT_PASSWORD: secreto
      MARIADB_DATABASE: miapp
    volumes:
      - db-data:/var/lib/mysql

  minio:
    image: elestio/minio
    command: server /data --console-address ":9001"
    environment:
      MINIO_ROOT_USER: admin
      MINIO_ROOT_PASSWORD: secreto123
    volumes:
      - minio-data:/data

volumes:
  db-data:
  minio-data:

$ docker compose up -d      # los cuatro servicios, juntos
$ docker compose down

Compose crea una red propia donde cada servicio es alcanzable por su nombre: Docker resuelve db y minio a la IP de esos contenedores (DNS interno).

• En DB_URL la base de datos es db:3306, no localhost: el contenedor de la app no es el mismo que el de la BBDD.
• Lo mismo con S3_ENDPOINT: http://minio:9000.
• Solo nginx publica puerto al exterior (80:80): la app, la BBDD y MinIO viven en la red interna y no son accesibles desde el host. La superficie de exposición es mínima y coincide con la de un despliegue real.

depends_on ordena el arranque de los servicios.

server {
    listen 80;

    location /api/ {
        proxy_pass http://app:8080;
    }

    location / {
        root /usr/share/nginx/html;
    }
}

Para el navegador todo sale del mismo servidor: el frontend en / y la API en /api/. El proxy usa el nombre app de la red interna; si la app cambia de nombre o de puerto, solo toca este fichero.