EurekaServerConfiguration/README.md

Eureka Server Configuration

A Spring Boot microservice that acts as a service registry for the Task Management System. This Eureka Server provides service discovery capabilities for all microservices in the system.

Features

• Service Registration and Discovery: Allows microservices to register themselves and discover other services
• Health Monitoring: Monitors the health of registered services
• Load Balancing Support: Provides client-side load balancing information
• Circuit Breaker Integration: Works with Hystrix for fault tolerance
• Distributed Tracing: Integrated with Zipkin for request tracing
• Actuator Endpoints: Comprehensive monitoring and management endpoints

Prerequisites

• Java 17 or higher
• Gradle 8.5 or higher
• Docker (for containerized deployment)

Configuration

Local Development

The application uses application.properties for local development configuration:

• Server runs on port 8085
• Eureka dashboard available at http://localhost:8085

Docker Deployment

The application uses application-docker.properties for Docker deployment:

• Configured for container networking
• Zipkin integration with container service names

Building the Application

# Build with Gradle
./gradlew build

# Build Docker image
docker build -t eureka-server:1.0.0 .

Running the Application

Local Development

# Run with Gradle
./gradlew bootRun

# Run JAR file
java -jar build/libs/eureka-server.jar

Docker

# Run Docker container
docker run -p 8085:8085 eureka-server:1.0.0

Endpoints

Eureka Dashboard

• URL: http://localhost:8085
• Description: Web UI for viewing registered services

Actuator Endpoints

• Health: http://localhost:8085/actuator/health
• Info: http://localhost:8085/actuator/info
• Metrics: http://localhost:8085/actuator/metrics
• All Endpoints: http://localhost:8085/actuator

API Endpoints

• Info: http://localhost:8085/info
• Home: http://localhost:8085/

Health Checks

The application includes comprehensive health checks:

• Custom Eureka health indicator
• Actuator health endpoints
• Docker health checks
• Liveness and readiness probes

Monitoring

Metrics

• Micrometer metrics integration
• Prometheus metrics endpoint
• JVM and system metrics

Logging

• Structured JSON logging (in Docker)
• Log rotation and retention
• Configurable log levels

Tracing

• Zipkin distributed tracing
• Request correlation IDs
• Performance monitoring

Configuration Properties

Property	Description	Default
server.port	Server port	8085
eureka.server.enable-self-preservation	Enable self-preservation mode	true
eureka.server.renewal-percent-threshold	Renewal threshold percentage	0.85
eureka.server.eviction-interval-timer-in-ms	Eviction interval	30000

Security

• Runs as non-root user in Docker
• Health checks for container orchestration
• Actuator endpoints secured appropriately
• Network security through container networking

Performance Tuning

• Optimized JVM settings for containers
• Response cache configuration
• Renewal and eviction timers optimized
• G1 garbage collector for better performance

Troubleshooting

Common Issues

1. Service not registering

   • Check network connectivity
   • Verify service configuration
   • Check Eureka client configuration

2. High CPU usage

   • Check eviction interval settings
   • Monitor garbage collection
   • Review renewal threshold

3. Memory issues

   • Adjust JVM heap settings
   • Monitor registered services count
   • Check for memory leaks

Logs Location

• Local: logs/eureka-server.log
• Docker: Container stdout/stderr

Development

Project Structure

src/
├── main/
│   ├── java/
│   │   └── in/garvit/tasks/
│   │       ├── EurekaServerConfigurationApplication.java
│   │       ├── config/
│   │       │   └── EurekaServerConfig.java
│   │       └── controller/
│   │           ├── EurekaHealthIndicator.java
│   │           └── EurekaInfoController.java
│   └── resources/
│       ├── application.properties
│       ├── application-docker.properties
│       ├── logback-spring.xml
│       └── META-INF/
│           └── additional-spring-configuration-metadata.json
└── test/
    └── java/

Building and Testing

# Run tests
./gradlew test

# Build application
./gradlew build

# Check dependencies
./gradlew dependencies

License

This project is part of the Task Management System microservices architecture.

Author

garvitpathak27 - Initial work and maintenance