Microservicio Spring Boot para la gestion del catalogo dentro de la arquitectura de microservicios 2026.
Actualmente incluye:
- API REST funcional
- Persistencia con MySQL
- Configuracion por perfiles (
dev,prod) - Contenerizacion con Docker
- Integracion operativa con Config Server
- Integracion operativa con Registry Server (Eureka)
- Integracion operativa con API Gateway
- Enrutamiento dinamico con
lb://catalogo - Observabilidad basica manual para salud, metricas y logs
- Integracion lista para observabilidad externa con Prometheus, Loki y Grafana
Client -> API Gateway -> Microservicios -> Registry Server -> Config Server
Este repositorio implementa unicamente el microservicio Catalogo.
- Java 17
- Spring Boot 3.5.x
- Spring Cloud 2025.x
- Maven 3.9+
- MySQL 8
- Docker
- Docker Compose
- Spring Cloud Config Client
- Eureka Client
- Flyway
- Actuator
- SpringDoc OpenAPI
| Servicio | Puerto expuesto |
|---|---|
| Catalogo DEV | 8081 |
| Catalogo PROD | 8082 |
| MySQL DEV | 3381 |
| MySQL PROD | 3382 |
| Config Server DEV | 7071 |
| Config Server PROD | 7072 |
| Registry Server DEV | 7081 |
| Registry Server PROD | 7082 |
| Gateway DEV | 7091 |
| Gateway PROD | 7092 |
| Modo | Ejecucion app | Base de datos | Configuracion | Registro | Puerto app |
|---|---|---|---|---|---|
| DEV | mvn spring-boot:run |
Docker/local | Config Server DEV | Registry DEV | 8081 |
| PROD | Docker | Docker | Config Server PROD | Registry PROD | 8082 |
catalogo participa principalmente en:
S1-S4como microservicio base, configurable, registrable y enrutable por GatewayS6como servicio remoto consumido porproductoS7como fuente de metricas, logs y trazabilidad
En esta etapa, catalogo no implementa Feign ni Circuit Breaker, pero si forma parte del flujo distribuido que se observa y protege.
catalogo participa en la observabilidad basica manual del sistema con:
GET /actuator/healthGET /actuator/metricsGET /actuator/prometheusGET /api/v1/catalogo/instancia- logs con
traceIden consola y archivo local
Archivo de log en desarrollo:
services/catalogo/logs/catalogo.log
Para la guia didactica paso a paso de observabilidad, evaluacion y evidencia transversal entre gateway, producto y catalogo, revisar:
- SESION-06.P2-OBSERVABILIDAD.md
- SESION-07-OBSERVABILIDAD-CON-HERRAMIENTAS.md
En modo productivo, catalogo ya queda listo para integrarse con la capa centralizada:
- Prometheus consume metricas desde
/actuator/prometheus - Promtail recoge
services/catalogo/logs/*.log - Loki centraliza los logs
- Grafana consulta metricas y logs desde una sola interfaz
Ejecutar catalogo en modo desarrollo consumiendo configuracion externa y registrando la instancia en Eureka.
Desde infra/config-server:
mvn spring-boot:runPrueba:
http://localhost:7071/catalogo/dev
Desde infra/registry-server:
mvn spring-boot:runDashboard:
http://localhost:7081
Desde services/catalogo:
docker compose -f docker-compose-dev.yml up -dDesde services/catalogo:
mvn spring-boot:runSwagger UI:
http://localhost:8081/swagger-ui/index.html
Endpoint de instancia:
http://localhost:8081/api/v1/catalogo/instancia
Acceso via Gateway DEV:
http://localhost:7091/api/v1/catalogo/instancia
Registro en Eureka:
http://localhost:7081
Para levantar una segunda instancia local de catalogo en desarrollo, ejecuta la aplicacion en otro puerto:
mvn spring-boot:run "-Dspring-boot.run.arguments=--server.port=8085"Prueba la segunda instancia:
http://localhost:8085/swagger-ui/index.html
http://localhost:8085/api/v1/catalogo/instancia
Ejecutar catalogo en contenedor Docker consumiendo configuracion externa y registro de servicio en Eureka.
Desde infra:
docker compose up -dPruebas:
http://localhost:7072/catalogo/prod
http://localhost:7082
En services/catalogo/.env:
CATALOGO_MYSQL_ROOT_PASSWORD=root
CATALOGO_MYSQL_DATABASE=db_catalogo
SPRING_PROFILES_ACTIVE=prod
CONFIG_SERVER_URL=http://config-server:7071
CATALOGO_DB_HOST=mysql-catalogo
CATALOGO_DB_PORT=3306
CATALOGO_DB_NAME=db_catalogo
CATALOGO_DB_USERNAME=root
CATALOGO_DB_PASSWORD=rootms-net-> red comun de infraestructura (config-server, registry-server, gateway futuro, microservicios)catalogo-int-> red interna de catalogo (mysql + app)
Desde services/catalogo:
docker compose up -dAPI:
http://localhost:8082/api/v1/categorias
Endpoint de instancia:
http://localhost:8082/api/v1/catalogo/instancia
Acceso via Gateway PROD:
http://localhost:7092/api/v1/catalogo/instancia
Eureka PROD (host):
http://localhost:7082
Archivos esperados:
infra/config-repo/catalogo-dev.yml
infra/config-repo/catalogo-prod.yml
Puntos clave ya configurados:
catalogo-dev.ymlusaeureka.client.service-url.defaultZone=http://localhost:7081/eurekacatalogo-prod.ymlusaeureka.client.service-url.defaultZone=http://registry-server:7081/eureka
docker compose downdocker compose up -d mysql-catalogodocker build -t catalogo-service .docker create `
--name catalogo1 `
--network ms-net `
--env-file .env `
-p 8082:8082 `
catalogo-service
docker network connect catalogo-int catalogo1
docker start catalogo1docker create `
--name catalogo2 `
--network ms-net `
--env-file .env `
-p 8083:8082 `
catalogo-service
docker network connect catalogo-int catalogo2
docker start catalogo2docker create `
--name catalogo3 `
--network ms-net `
--env-file .env `
-p 8084:8082 `
catalogo-service
docker network connect catalogo-int catalogo3
docker start catalogo3http://localhost:8082/api/v1/categorias
http://localhost:8083/api/v1/categorias
http://localhost:8084/api/v1/categorias
http://localhost:8082/api/v1/catalogo/instancia
http://localhost:8083/api/v1/catalogo/instancia
http://localhost:8084/api/v1/catalogo/instancia
Si quieres validar balanceo por Gateway, repite varias veces:
http://localhost:7092/api/v1/catalogo/instancia
- Config Server no accesible -> faltaba red
ms-net - Registry Server no accesible -> infraestructura no levantada completa
- MySQL no accesible -> faltaba red
catalogo-int - Error datasource -> configuracion externa no cargada
- Error
UnknownHost-> nombres de host/redes mal definidos
Orden aplicado durante la implementacion:
- Crear o clonar repo
infradesde el tagvs03-registry-servery repocatalogotambien desdevs03-registry-server. - Crear proyecto
gatewayeninfra. - Conectar
gatewaya Config Server. - Probar
gatewayen DEV. - Suscribir
gatewaya Eureka en modo DEV. - Definir ruta:
uri: lb://catalogo. - Escalado en DEV con multiples instancias.
- Configurar
gatewaypara PROD. - Probar
gatewayen PROD. - Levantar varias instancias de
catalogoen PROD y probar. - Revision de escalado automatico.
- Config Server
- Registry Server (Eureka)
- API Gateway
- Enrutamiento
lb://catalogo - Observabilidad basica manual
- Observabilidad con herramientas
- Feign
- Circuit Breaker
- Seguridad
- Gestion del trafico (filtros, politicas y control de peticiones)
- Integracion con frontend
Continuar con atributos de calidad sobre la base actual:
- seguir participando en el flujo distribuido observado desde
S6yS7 - integrar seguridad con autenticacion y autorizacion
- aplicar gestion del trafico en Gateway
- habilitar integracion con frontend
git tag -a vs07-obs-tools -m "Catalogo listo para observabilidad externa con Prometheus, Loki y Grafana"
git push origin vs07-obs-tools