Microservicio de ordenes con Spring Boot, MySQL y Kafka.
Group Id: com.upeu
Artifact Id: ec-orden-ms
Package Name: com.upeu.ec.ordenms
- App:
http://localhost:19021 - MySQL:
localhost:19020 - Kafka:
localhost:49092 - Topic:
orden-eventos - Red Docker de Kafka en
dev:ec-kafka-dev-net
- 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
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
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-msLevantar la base de datos de desarrollo:
docker compose -f docker-compose-dev.yml up -dVerificar contenedores:
docker compose -f docker-compose-dev.yml psAntes 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-msLevantar el stack:
docker compose up -dVerificar contenedores:
docker compose psAccesos esperados en prod:
- App:
http://localhost:29021 - MySQL:
localhost:29020 - Red de aplicacion:
ec-orden-ms-net - Red Kafka externa:
ec-kafka-prod-net
El docker-compose.yml de prod usa estas variables:
SPRING_PROFILES_ACTIVEEC_KAFKA_BOOTSTRAP_SERVERSEC_ORDEN_MS_DB_HOSTEC_ORDEN_MS_DB_PORTEC_ORDEN_MS_DB_NAMEEC_ORDEN_MS_DB_USERNAMEEC_ORDEN_MS_DB_PASSWORDEC_ORDEN_MS_MYSQL_ROOT_PASSWORDEC_ORDEN_MS_MYSQL_DATABASE
Ejecutar la aplicacion:
.\mvnw.cmd spring-boot:runLa aplicacion quedara disponible en:
http://localhost:19021
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:
- Buscar el endpoint
POST /ordenes - Hacer clic en
Try it out - Enviar un body como este:
{
"usuarioId": 1,
"total": 100
}Tambien puedes ver el OpenAPI JSON en:
http://localhost:19021/v3/api-docs
Entrar al broker de dev:
docker exec -it ec-kafka-dev bashConsumir el topico:
/opt/kafka/bin/kafka-console-consumer.sh \
--topic orden-eventos \
--bootstrap-server ec-kafka:9092 \
--from-beginningLuego de hacer el POST /ordenes, debe aparecer algo como:
{"tipoEvento":"orden.creada","ordenId":1,"total":100.0,"estado":"PENDIENTE"}- Levantar MySQL DEV en
ec-orden-ms - Ejecutar
.\mvnw.cmd spring-boot:run - Hacer
POST /ordenes - Verificar el evento en Kafka
En prod, ec-orden-ms se conecta a la red externa ec-kafka-prod-net, que debe existir previamente al levantar el stack.