Microservices Demo

A demo application using the microservices architecture.

Prerequisites

• Java 24+
• A Docker environment supported by Testcontainers: https://www.testcontainers.org/supported_docker_environment/ (a recent local Docker installation is enough)

Getting Started

Clone the repository and run the following command to build the project:

./mvnw clean verify

Running the service in development

Move to the people-service directory:

cd people-service

Run the following command:

./mvnw spring-boot:run

Try the services at http://localhost:8080/swagger-ui.html.

Try the web application using the service at http://localhost:8082/.

Running the web application in development

Move to the people-web directory:

cd people-web

Run the following command:

./mvnw spring-boot:run

Try the web application at http://localhost:8080.

The people service is available at http://localhost:8081/api/v1/people. (also with Swagger UI at http://localhost:8081/swagger-ui.html)

The Eureka discovery service dashboard is available at http://localhost:8761.

The Config server is available at http://localhost:8088. For example, the people service configuration is available at http://localhost:8088/DemoPerson/docker.

Running the application with Docker Compose

A docker-compose-.yml file is provided to run the service with Docker Compose. In the main directory:

docker compose -f docker-compose.yml up

Try the services at http://localhost:8081/swagger-ui.html.

Try the web application using the service at http://localhost:8082/.