ordered-eureka

Service discovery for the ordered-system microservices platform — a small e-commerce marketplace inspired by Allegro, built to practice distributed-systems patterns.

This is a bare Netflix Eureka server. Every other service in the system (gateway and the four business services) registers itself here on startup and asks it "where is product-service right now?" instead of hardcoding hostnames — which is what makes it possible to scale a service to N instances or move it to a different container without touching any other service's config.

Role in the system

                 ┌────────────────┐
                 │ ordered-eureka │  ← you are here
                 │   port 8761    │
                 └────────▲───────┘
                          │ register / discover
        ┌─────────┬───────┼───────┬─────────┐
        │         │       │       │         │
   gateway    order-svc  product-svc  user-svc  engagement-svc

Standalone, single-instance registry — this is a portfolio/demo system, not a multi-region deployment, so peer replication between multiple Eureka nodes isn't set up. Self-preservation mode is disabled so the registry evicts dead instances promptly instead of assuming a network partition, which is the right trade-off for a small dev/demo cluster.

Stack

Java 21 · Spring Boot 4.1.0 · Spring Cloud Netflix Eureka Server

Running it

Needs nothing else running first — it's the first thing you start.

./mvnw spring-boot:run

Dashboard: http://localhost:8761 — lists every registered instance, its status (UP/DOWN), and metadata.

Docker

docker build -t ordered-eureka .
docker run -p 8761:8761 ordered-eureka

In the full stack (see ordered-infra), other services find it via the EUREKA_URL environment variable, defaulting to http://localhost:8761/eureka/.

Where this fits

Part of the ordered-system organization — see the org profile for the full map of repositories, or ordered-infra for how to run the whole platform together.

License

MIT — see LICENSE.