Demonstrates how to create Java/Spring based microservices using modern approaches:
- Service Discovery (HashiCorp Consul)
- API Gateway (Spring Cloud Gateway)
- Client-side load-balancing (Spring Cloud LoadBalancer)
- OpenID Connect based user authentication (Spring Security/Keycloak)
- Distributed sessions (Spring Session/Redis)
- OAuth 2.0 scope based service-to-service authorization (Spring Security/Keycloak)
- Data caching (Spring Cache/Redis)
- Cloud Bus to broadcast cache invalidation notifications between microservices (Spring Cloud Bus/Apache Kafka)
- Database schema evolution (Liquibase)
- Java classes mapping (MapStruct)
- Distributed tracing (Spring Sleuth/Zipkin)
- Containerized microservices (Docker)
- Infrastructure as Code (HashiCorp Terraform)
- JDK 11
- Maven
- Docker
- Docker Compose
- Terraform
- Run under infrastructure directory
docker-compose up -d
- Run under infrastructure/terraform directory
source ./env.sh
- Run under infrastructure/terraform/0100-database directory
terraform init
terraform apply
- Run under infrastructure/terraform/0200-oidc directory
terraform init
terraform apply
- Run under infrastructure/terraform/0300-consul directory
terraform init
terraform apply
You can access some infrastructure services using the following addresses:
| Service | Address | Credentials |
|---|---|---|
| Consul | http://localhost:8500 | |
| Keycloak | http://localhost:8180 | admin/secret |
| Kafdrop | http://localhost:9000 | |
| Zipkin | http://localhost:9411 |
- Build and run microservices in api-gateway, messages-service and profiles-service directories
mvn -DskipTests spring-boot:run
- Build docker containers for microservices in api-gateway, messages-service and profiles-service directories
mvn -DskipTests clean package docker:build
- Start microservices containers
docker-compose up -d
Open in a browser the following URLs to see the inbox and outbox messages:
http://localhost:8080/api/messages/message/inbox
http://localhost:8080/api/messages/message/outbox
You will be redirected to the login page. Use one of the following users - victor.fisyuk, john.doe (use secret as password).
By default, there are no messages. You could send new messages using Postman collection postman_collection.json. You could also update user profiles using Postman.