Eureka란?

📌 1. Eureka란?

Eureka는 Netflix에서 개발한 서비스 디스커버리 및 로드 밸런싱을 제공하는 도구 

 

주로 Spring Cloud에서 서비스 디스커버리 솔루션으로 사용되는데, 이 경우 서비스들이 동적으로 등록되고 서비스 위치 정보를 중앙에서 관리하기 때문에 Gateway에서 각 서비스의 uri를 직접 설정할 필요없다.

 

✅ Eureka의 주요 개념

1️⃣ Eureka Server

• Eureka Server는 여러 마이크로서비스들이 서로를 찾을 수 있도록 서비스 정보를 저장하고 제공.
• 여러 개의 Eureka 서버를 클러스터링하여 고가용성을 보장할 수 있다.

 

2️⃣ Eureka Client ( 서비스 등록 & 서비스 검색 )

• 서비스가 Eureka Server에 자신을 등록하고, 다른 서비스를 찾기 위해 Eureka Client를 사용.
• 주기적으로 자신이 실행되고 있는 호스트와 포트를 Eureka Server에 알린다.
• 클라이언트는 Eureka Server에서 제공하는 서비스 목록을 조회하고, 서비스 인스턴스를 선택하여 통신할 수 있다.

✅ Eureka의 주요 역할

1️⃣ 서비스 디스커버리 (Service Discovery)

• 클라이언트나 다른 서비스가 서비스를 찾을 때, Eureka Server에서 서비스 목록을 조회하여 필요한 서비스의 위치를 찾을 수 있다.
• 이 방식으로 서비스가 동적으로 확장되거나 축소되어도 클라이언트는 서비스의 실제 위치를 알 필요 없이 Eureka를 통해 자동으로 찾을 수 있다.

 

2️⃣ 로드 밸런싱 및 Fault Tolerance

• Eureka는 여러 인스턴스가 등록된 경우 클라이언트에서 라운드 로빈(Round-Robin) 방식으로 요청을 분배할 수 있도록 지원합니다.
• 특정 서비스 인스턴스가 응답하지 않는 경우, Eureka는 이를 제거하고 다른 인스턴스를 사용하도록 합니다.

 

3️⃣ 상태 갱신(heartbeat 체크) & 자체 복구 기능 (Self-healing)

• Eureka Client는 일정 주기로 Heartbeat 신호를 Eureka Server에 보내 서비스 상태를 갱신한다.
• Heartbeat 신호를 받지 못한 경우 Eureka Server는 해당 서비스를 DOWN 상태로 표시 or 목록에서 제거.
• 서비스가 다시 시작되면 Eureka에 다시 등록되어 자동으로 복구된다.

 

⭐ 인스턴스 상태

• 헬스체크 실패 시 : status Down으로 변경
• 헬스체크 일정기간(leaseExpirationDurationInSeconds, 기본 90초) 동안 실패: 등록 해제
• 비활성화(관리자 또는 시스템이 설정): 유지보수 등의 이유로 일시적으로 제외하는 것, 서비스는 실행 중 이지만 클라이언트 요청을 받지 않도록 설정됨.

상태	설명	Eureka에 등록	서비스 디스커버리	자동 복구
OUT_OF_SERVICE	서비스가 일시적으로 사용 중지됨 (보통 수동 설정)	✅ (등록됨)	❌ (조회 불가)	✅ (UP으로 변경하면 즉시 복구됨)
DOWN	서비스가 장애로 인해 동작하지 않음	✅ (등록됨)	❌ (조회 불가)	✅ (UP으로 변경하거나 헬스 체크 복구 시 자동 복구)
DEREGISTERED	서비스가 완전히 삭제됨	❌ (등록 해제됨)	❌ (조회 불가)	❌ (새롭게 재등록해야 함)

 

📌 2. 서버 설정 방법

✅ 2-1. 의존성 추가

📖 build.gradle

implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-server'
dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:2024.0.0"
    }
}

*버전 참고

https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-dependencies

✅ 2-2. 애플리케이션 설정

📖 application.properties

spring.application.name=eureka

# Eureka 서버 포트 설정
server.port=8761

# Eureka 서버 설정
 # 이 서버는 다른 서버에 등록하지 않음
eureka.client.registerWithEureka=false
 # 이 서버는 다른 서버의 정보를 가져오지 않음
eureka.client.fetchRegistry=false
# 서버 자기 보호 모드 비활성화
eureka.server.enableSelfPreservation=false
# 이 설정을 통해 기본 UI를 활성화할 수 있음
management.endpoints.web.exposure.include=*

 

✅ 2-3. @EnableEurekaServer 추가

📖 main class

package com.example.eureka;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

@SpringBootApplication
@EnableEurekaServer
public class EurekaApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaApplication.class, args);
    }
}

 

📌 3. Client 설정 방법

✅ 3-1. 의존성 추가

📖 build.gradle

//eureka
implementation 'org.springframework.cloud:spring-cloud-starter-netflix-eureka-client'
implementation 'org.springframework.boot:spring-boot-starter-actuator'

 

✅ 3-2. 애플리케이션 설정

📖 application.properties

spring.application.name=gateway

# Spring Cloud Gateway 설정

# 서버 포트 설정
server.port=8080

# 라우트 설정
# Eureka 서비스 디스커버리와 통합
# 등록된 서비스 이름을 사용하여 여러 인스턴스에 대해 로드 밸런싱을 수행.
spring.cloud.gateway.routes[0].id=to_service1
spring.cloud.gateway.routes[0].uri=lb://SERVICE-1
spring.cloud.gateway.routes[0].predicates[0]=Path=/service1/**
spring.cloud.gateway.routes[0].filters[0]=AddRequestHeader=X-Gateway-Header, Gateway-Value

# Eureka 서버 URL (Eureka와 연동 시)
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/

# Eureka 서비스 등록을 통한 동적 라우팅 활성화
spring.cloud.gateway.discovery.locator.enabled=true
# eureka server registry에 현재 애플리케이션 자신의 정보를 등록할지 (다른 서비스들이 name으로 접근가능)
eureka.client.registerWithEureka=true
# registry에 있는 정보(등록된 서비스 목록)들을 가져올지 여부
eureka.client.fetchRegistry=true
#Actuator 엔드포인트 활성화 -> 안 해도 되는데 유레카 서버에서 조회하는게 있음.
management.endpoints.web.exposure.include=*

 

✅ 3-3. @EnableDiscoveryClient추가 (최신 버전에서 생략 가능)

📖 main class

import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

📌 4. 서비스 확인

애플리케이션 실행 후 http://localhost:8761(유레카 서버 포트) 로 접속하여 등록된 서비스확인 가능.

• Instances 에서 등록한 application이 조회된다.
• status링크 클릭 시 http://desktop-2lii5um:8080/actuator/info로 이동된다.

 

❌ 에러: Invalid host: lb://{service_name}

[139c33b5] There was an unexpected error (type=Internal Server Error, status=500).
Invalid host: lb://product_service

2025-01-08T13:03:38.745+09:00 INFO 14960 --- [gateway] [nio-8080-exec-5] o.apache.coyote.http11.Http11Processor : Error parsing HTTP request header Note: further occurrences of HTTP request parsing errors will be logged at DEBUG level. java.lang.IllegalArgumentException: Invalid character found in method name [0x160x030x010x000xf70x010x000x000xf30x030x030x850x020xcc00x8f>6\0xb60xd2e0xc20xb10xe80xa40xe60x86js0x8fl%,0xa90xd10x1aU0xd0,"0xbb0xcc ]. HTTP method names must be tokens
//…
[GatewayFilterAdapter{delegate=org.springframework.cloud.gateway.filter.ForwardRoutingFilter@1dde45af}, order = 2147483647]] 2025-01-08T13:04:00.262+09:00 ERROR 14960 --- [gateway] [nio-8080-exec-6] a.w.r.e.AbstractErrorWebExceptionHandler : [6b9f950f] 500 Server Error for HTTP GET "/product/api/products/all" java.lang.IllegalStateException: Invalid host: lb://product_service at

 

🛠 해결 방법

1. 서비스 명 대신 port 직접 설정

이렇게 하니까 접속됨. -> 유레카 문제인 것!!

spring.cloud.gateway.routes[1].uri=http://localhost:8083
# lb://product_service

 

2. 서비스 명 수정

Eureka에 등록하는 서비스에 _있으면 안된다고 한다. -로 수정하니까 접속됨.

spring.application.name=product-service