Arquitectura de Microservicios con Spring Boot y Docker Swarm

Transición a Sistemas Distribuidos#

La adopción de microservicios demanda una gestión rigurosa del estado, la configuración y el enrutamiento. Al combinar la robustez del ecosistema Spring (Spring Boot 3 + Spring Cloud) con la simplicidad operacional de Docker Swarm, logramos una orquestación ligera pero altamente efectiva para cargas de trabajo empresariales que no requieren la sobrecarga de un clúster Kubernetes completo.

El Patrón de Service Discovery y API Gateway

En una topología distribuida, el enrutamiento estático es un antipatrón. Utilizaremos Netflix Eureka o Consul para el descubrimiento dinámico, y Spring Cloud Gateway como punto de entrada unificado, encargándose del balanceo de carga, autenticación y rate limiting.

Nota Importante: Asegúrate de configurar correctamente los perfiles de Spring (spring.profiles.active) para separar la configuración de desarrollo y la de producción en Swarm. El uso de Spring Cloud Config Server es altamente recomendado para inyectar configuraciones en tiempo de ejecución de manera centralizada.

A continuación, un ejemplo de configuración base en application.yml para un microservicio cliente que se registra en Eureka:

server:
  port: 0 # Asignación dinámica de puerto
spring:
  application:
    name: customer-service
eureka:
  client:
    service-url:
      defaultZone: http://discovery-server:8761/eureka/
  instance:
    instance-id: ${spring.application.name}:${random.value}
    prefer-ip-address: true

Orquestación con Docker Swarm#

Mientras que el código de Spring Boot maneja la lógica de negocio y el enrutamiento a nivel de aplicación, Docker Swarm gestionará el ciclo de vida del contenedor, el escalado horizontal y la resolución DNS interna a nivel de red (Overlay Network).

Topología de Red y Stack Deployment

Para aislar el tráfico inter-servicio del tráfico externo, definiremos una red tipo overlay. El siguiente archivo docker-compose.yml (versión 3.8) ilustra el despliegue de nuestro ecosistema, incluyendo restricciones de ubicación (Placement) y políticas de reinicio (Restart Policies) para garantizar tolerancia a fallos.

version: '3.8'

services:
  discovery-server:
    image: forgenex/eureka-server:latest
    networks:
      - microservices-net
    deploy:
      replicas: 3
      placement:
        constraints:
          - node.role == manager
      update_config:
        parallelism: 1
        delay: 10s

  api-gateway:
    image: forgenex/spring-gateway:latest
    ports:
      - "80:8080"
    networks:
      - microservices-net
    depends_on:
      - discovery-server
    deploy:
      mode: replicated
      replicas: 4
      update_config:
        order: start-first
      restart_policy:
        condition: on-failure
        max_attempts: 3

  customer-service:
    image: forgenex/customer-service:1.2.0
    networks:
      - microservices-net
    environment:
      - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://discovery-server:8761/eureka/
      - SPRING_PROFILES_ACTIVE=prod
    deploy:
      replicas: 5
      resources:
        limits:
          cpus: '0.50'
          memory: 512M

networks:
  microservices-net:
    driver: overlay
    attachable: true

Inicialización y Monitoreo del Clúster

Para desplegar este stack en el clúster Swarm, el nodo mánager debe ejecutar el siguiente comando. Es vital usar el flag --with-registry-auth si las imágenes de Spring Boot provienen de un registro privado.

docker stack deploy -c docker-compose.yml forgenex_stack --with-registry-auth

Nota Importante: Docker Swarm utiliza un algoritmo de routing mesh. Aunque api-gateway expone el puerto 80, cualquier nodo del clúster puede recibir el tráfico en ese puerto y redirigirlo internamente al contenedor adecuado, garantizando alta disponibilidad sin requerir balanceadores externos complejos.

La monitorización de los microservicios desplegados debe integrarse con herramientas como Prometheus y Grafana, exponiendo métricas a través de Spring Boot Actuator y configurando un scrape job que consulte dinámicamente los endpoints registrados en Eureka.