// the find
piomin/sample-spring-microservices-new
Demo for Spring Boot and Spring Cloud microservices with distributed configuration (Spring Cloud Config), service discovery (Eureka), API gateway (Spring Cloud Gateway, Zuul), Swagger/OpenAPI documentation (Springdoc), logs correlation using Spring Cloud Sleuth/Micrometer OTEL and many more
A teaching demo for Spring Cloud's full infrastructure stack — Eureka, Config Server, Gateway, OpenFeign, and distributed tracing — wired together across six services. It exists to accompany blog posts by Piotr Minkowski, not to be a production template. Useful if you're learning how these pieces fit together and want something you can run locally in an afternoon.
The branch-per-topic structure is genuinely well organized — each Spring Cloud variant (Alibaba Nacos, GraphQL, OpenShift) lives in its own branch with a matching article, so you're not wading through conflicting configs. It's kept current with Spring Boot 3 and Micrometer OTEL tracing, which is the right migration from Sleuth. The unified Swagger UI through the gateway is a nice touch that shows how API aggregation actually works. CircleCI and SonarCloud integration means you can see real build and coverage numbers rather than guessing.
All data is in-memory repositories — there's no persistence at all, so the moment you restart a service you lose everything. That's fine for demos but means you can't use this as a starting point for anything real without reworking the data layer. The README still references JDK8 in one place and Zuul in the module descriptions despite the master branch having moved to Spring Cloud Gateway — it's sloppy and will confuse people who read it carefully. There are no meaningful tests: the test classes exist but appear to be mostly scaffolding rather than coverage of the actual service interactions. And it's fundamentally tied to the Spring Cloud Netflix stack, which has been in maintenance mode for years — if you're starting fresh, you probably want to evaluate whether Eureka+Ribbon is still the right choice in 2024.