Skip to content

About

Microservicio (Event-Driven Architecture, EDA) de ordenes con Spring Boot, MySQL y Kafka.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ec-orden-ms

Microservicio de ordenes con Spring Boot, MySQL y Kafka.

Datos del proyecto

Group Id:     com.upeu
Artifact Id:  ec-orden-ms
Package Name: com.upeu.ec.ordenms

Configuracion DEV

  • App: http://localhost:19021
  • MySQL: localhost:19020
  • Kafka: localhost:49092
  • Topic: orden-eventos
  • Red Docker de Kafka en dev: ec-kafka-dev-net

Configuracion PROD

  • App: http://localhost:29021
  • MySQL: localhost:29020
  • Kafka: configurado por variable EC_KAFKA_BOOTSTRAP_SERVERS
  • Topic: orden-eventos
  • Red Docker de Kafka en prod: ec-kafka-prod-net

Requisitos

Para trabajar con este proyecto necesitas:

  • JDK 17
  • Docker Desktop o Docker Engine
  • Kafka levantado en el ambiente correspondiente
  • MySQL disponible en el ambiente correspondiente

Desarrollo

Fase 2: Levantar MySQL DEV de ec-orden-ms

Antes de esta fase, Kafka dev debe estar levantado desde ec-kafka. Si ejecutas la aplicacion localmente, Spring puede conectarse a Kafka usando localhost:49092.

Ubicarse en:

cd C:\261bigdata\ec-orden-ms

Levantar la base de datos de desarrollo:

docker compose -f docker-compose-dev.yml up -d

Verificar contenedores:

docker compose -f docker-compose-dev.yml ps

Produccion

Levantar stack PROD de ec-orden-ms

Antes de levantar prod, verifica:

  • que exista la red Docker ec-kafka-prod-net
  • que las variables de entorno necesarias esten definidas

Ubicarse en:

cd C:\261bigdata\ec-orden-ms

Levantar el stack:

docker compose up -d

Verificar contenedores:

docker compose ps

Accesos esperados en prod:

  • App: http://localhost:29021
  • MySQL: localhost:29020
  • Red de aplicacion: ec-orden-ms-net
  • Red Kafka externa: ec-kafka-prod-net

Variables de entorno usadas en PROD

El docker-compose.yml de prod usa estas variables:

  • SPRING_PROFILES_ACTIVE
  • EC_KAFKA_BOOTSTRAP_SERVERS
  • EC_ORDEN_MS_DB_HOST
  • EC_ORDEN_MS_DB_PORT
  • EC_ORDEN_MS_DB_NAME
  • EC_ORDEN_MS_DB_USERNAME
  • EC_ORDEN_MS_DB_PASSWORD
  • EC_ORDEN_MS_MYSQL_ROOT_PASSWORD
  • EC_ORDEN_MS_MYSQL_DATABASE

Fase 3: Ejecutar ec-orden-ms

Ejecutar la aplicacion:

.\mvnw.cmd spring-boot:run

La aplicacion quedara disponible en:

http://localhost:19021

Fase 4: Probar el endpoint REST

Enviar una orden:

Invoke-RestMethod `
  -Method Post `
  -Uri "http://localhost:19021/ordenes" `
  -ContentType "application/json" `
  -Body '{"usuarioId":1,"total":100}'

Debe responder algo parecido a:

{
  "id": 1,
  "usuarioId": 1,
  "total": 100.0,
  "estado": "PENDIENTE"
}

Otra forma de probar POST /ordenes es usando Swagger UI.

Abrir en el navegador:

http://localhost:19021/swagger-ui/index.html

Luego:

  1. Buscar el endpoint POST /ordenes
  2. Hacer clic en Try it out
  3. Enviar un body como este:
{
  "usuarioId": 1,
  "total": 100
}

Tambien puedes ver el OpenAPI JSON en:

http://localhost:19021/v3/api-docs

Fase 5: Verificar el evento en Kafka

Entrar al broker de dev:

docker exec -it ec-kafka-dev bash

Consumir el topico:

/opt/kafka/bin/kafka-console-consumer.sh \
  --topic orden-eventos \
  --bootstrap-server ec-kafka:9092 \
  --from-beginning

Luego de hacer el POST /ordenes, debe aparecer algo como:

{"tipoEvento":"orden.creada","ordenId":1,"total":100.0,"estado":"PENDIENTE"}

Resumen rapido

  1. Levantar MySQL DEV en ec-orden-ms
  2. Ejecutar .\mvnw.cmd spring-boot:run
  3. Hacer POST /ordenes
  4. Verificar el evento en Kafka

Nota de produccion

En prod, ec-orden-ms se conecta a la red externa ec-kafka-prod-net, que debe existir previamente al levantar el stack.

About

Microservicio (Event-Driven Architecture, EDA) de ordenes con Spring Boot, MySQL y Kafka.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages