Eureka란?

📌 1. Eureka란?

• Eureka는 Netflix에서 개발한 서비스 디스커버리 도구 
• 서비스들이 동적으로 등록되고 서비스 위치 정보를 중앙에서 관리, Gateway에서 각 서비스의 uri를 직접 설정할 필요없다.

 

✅ 1-1. Eureka의 주요 개념

1️⃣ Eureka Server

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

 

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

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

 

✅ 1-2. Eureka의 주요 역할

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

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

 

2️⃣ 로드 밸런싱 및 Fault Tolerance

• Spring Cloud 프로젝트에서는 Spring Cloud LoadBalancer가 기본적으로 Eureka와 연동
• 클라이언트(RestTemplate, WebClient, Feign)에서 @LoadBalanced를 쓰면, Eureka에서 인스턴스 목록 조회 → LoadBalancer가 Round-Robin, Random 등 전략으로 선택 → 요청 분배
  
• 특정 서비스 인스턴스가 응답하지 않는 경우, 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로 이동된다.

 

✅ 4-1. System Status 옵션

📖 옵션 예시

항목	값
등록된 서비스 수	4개 (GATEWAY, NOTE, SECURITY, USER)
각 서비스 인스턴스 수	1개씩
Renews threshold	8
Renews (last min)	16
Lease expiration enabled	true

🔹Renews threshold란?

Eureka가 “적어도 이 정도 갱신은 와야 인스턴스들이 정상적으로 살아있구나” 판단하는 기준값. => 인스턴스 수 X 분당 기대되는 renewal 횟수로 정해진다.

 

🔹 Renews (last min): 16 의미는?

• 실제로 Eureka가 지난 1분간 받은 갱신(heartbeat) 요청 수
• Eureka는 등록된 인스턴스 수 × 2 만큼의 renewal 이 기본적으로 1분에 와야 한다고 예상, 기본 renewal 간격: 30초마다 한 번 (default)
• 16번이면 각 인스턴스가 정상적으로 2번씩 heartbeat를 보내고 있다는 뜻! (4개 × 2 = 8 × 2 = 16)
• 💡 renewal 설정 바꾸고 싶다면?

eureka:
  instance:
    lease-renewal-interval-in-seconds: 30     # 기본값 (30초마다 갱신)
    lease-expiration-duration-in-seconds: 90  # 갱신이 이 시간 안에 없으면 DOWN 처리

 

✅ 4-2. ❌ 에러: Invalid host: lb://{service_name}

❌ 에러: 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

 

📌 5. Eureka 보안 설정

✅ 5-1. 기본 Eureka의 보안 취약점

⚠️ 기본적으로 인증/인가 없이 동작, 누구나 접근 가능

• http://<eureka-server>:8761/eureka/apps 로 직접 REST 호출해서 서비스 등록 가능
• POST, PUT, DELETE 요청을 날리면 등록/제거도 가능함
  
  

✅5-2. Eureka 보안 강화 방법들 🛠

1️⃣ Spring Security 연동 (기본 인증): Eureka 서버에 인증을 추가

spring:
  security:
    user:
      name: admin
      password: admin

 

클라이언트 쪽에서 eureka.client.service-url.defaultZone 설정에 인증 정보를 포함해줘야 한다.

eureka:
  client:
    service-url:
      defaultZone: http://admin:admin@<eureka-server-ip>:8761/eureka/

 

2️⃣ 방화벽/네트워크 제한

• 인프라 레벨에서 IP 화이트리스트 방식으로 Eureka 접근 차단
• 사내망 또는 VPN 내부에서만 노출

3️⃣ HTTPS 사용

• SSL 인증서를 붙여서 통신을 암호화 (중간자 공격 방지)
  

4️⃣ 서비스 등록용 토큰/필터 구현 (커스터마이징)

• 직접 Eureka 서버에 Filter 또는 Interceptor를 붙여서 등록 요청 시 토큰 검증 등 추가 가능