📖 개요

Spring Cloud Eureka
마이크로서비스 환경에서 서비스 등록 및 위치 조회를 관리하는 서비스 디스커버리 서버

왜 사용하는지

서비스가 여러 개로 분리된 환경에서는
각 서비스의 IP / Port를 직접 관리하기 어려움

서비스가 실행될 때 자동으로 Eureka Server에 등록되고
다른 서비스가 필요한 서비스의 위치를 조회할 수 있도록 지원

해결하는 문제

• 서비스 위치 관리 문제 해결
• 서비스 인스턴스 확장 관리
• 장애 서비스 자동 제외

핵심 특징

• Service Registration (서비스 등록)
• Service Discovery (서비스 조회)
• 로드밸런싱 지원
• Health Check 기반 장애 감지

Spring Cloud 프로젝트 생성
https://start.spring.io/

---

⚙️ 핵심 개념

1️⃣ Service Registration (서비스 등록)

서비스가 실행될 때 Eureka Server에 자신의 정보를 등록

등록 정보

• 서비스 이름
• IP 주소
• Port
• 서비스 상태

구성

Eureka Server

• 등록된 서비스 목록 관리
• 서비스 위치 정보 제공

Eureka Client

• 자신의 서비스 정보를 Eureka Server에 등록
• 필요한 서비스 위치 조회

---

2️⃣ Service Discovery (서비스 위치 조회)

서비스가 다른 서비스를 호출할 때
Eureka Server를 통해 서비스 위치 조회

기존 방식

Client → 직접 서비스 주소 호출

문제

• 서비스 주소 변경 시 코드 수정 필요
• 인스턴스 확장 관리 어려움

Eureka 방식

Client → Eureka Server → Service Instance

장점

• 서비스 위치 자동 관리
• 인스턴스 확장 자동 반영
• 동적 서비스 호출 가능

---

3️⃣ 서비스 호출 방식

RestTemplate 방식

서비스 호출 시 로드밸런싱 적용 필요

@LoadBalanced
RestTemplate

특징

• 서비스 이름 기반 호출 가능
• Spring Cloud LoadBalancer 사용

하지만 현재 프로젝트에서는 RestTemplate 방식 사용하지 않음

---

Feign Client 방식 (프로젝트 사용)

인터페이스 기반 HTTP Client

특징

• 인터페이스 선언만으로 API 호출 가능
• 서비스 이름 기반 호출
• 코드 간결

구조

Client → Feign Client → Eureka → Target Service

예시 코드

@FeignClient(name = "store-service")
public interface StoreClient {

    @GetMapping("/stores/{id}")
    StoreResponse getStore(@PathVariable Long id);
}

설명

• name 값이 서비스 이름
• Eureka에서 해당 서비스 위치 조회 후 호출

---

4️⃣ Health Check 및 장애 처리

Eureka는 서비스 상태를 헬스 체크 기반으로 관리

헬스 체크 엔드포인트

/actuator/health

동작 구조

Service → Eureka Server → 상태 보고

상태 예시

• UP
• DOWN
• OUT_OF_SERVICE

장애 발생 시

Eureka가 해당 인스턴스를 서비스 목록에서 제외

다른 정상 인스턴스로 트래픽 전달

효과

• 장애 서비스 자동 차단
• 백업 인스턴스 사용 가능

---

🔍 동작 원리

서비스 등록 흐름

Service Instance → Eureka Server 등록

서비스 호출 흐름

Client Service
↓
Eureka Server (서비스 위치 조회)
↓
Target Service Instance

Feign Client 사용 시

Client → Feign Client → Eureka → Target Service

---

💻 코드 예시

Eureka Server 설정

메인 클래스

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }

}

application.properties

spring.application.name=eureka-server
server.port=19090

eureka.client.register-with-eureka=false
eureka.client.fetch-registry=false
eureka.client.service-url.defaultZone=http://localhost:19090/eureka/

설명

Eureka Server는 서비스 등록 서버 역할
자기 자신을 등록하지 않기 때문에 false 설정 사용

---

Eureka Client 설정

메인 클래스

@SpringBootApplication
@EnableDiscoveryClient
public class FirstServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(FirstServiceApplication.class, args);
    }

}

application.properties

spring.application.name=first-service
server.port=19091

eureka.client.service-url.defaultZone=http://localhost:19090/eureka/

두 번째 서비스 예시

spring.application.name=second-service
server.port=19092

eureka.client.service-url.defaultZone=http://localhost:19090/eureka/

---

🚀 사용 사례

마이크로서비스 환경에서 서비스 호출 관리

예시 구조

Client
↓
API Gateway
↓
Microservices

Microservices

• User Service
• Store Service
• Order Service
• Payment Service

서비스 등록 구조

각 서비스 → Eureka Server 등록

서비스 호출

Service → Eureka → 다른 서비스 호출

서비스 IP 변경이나 인스턴스 추가 시
Eureka가 자동으로 관리

---

🔎 Eureka Dashboard 확인

Eureka Server 실행 후 브라우저 접속

http://localhost:19090/

또는

http://localhost:19090/eureka/

확인 포인트

Instances currently registered with Eureka

여기에 다음 서비스가 보이면 정상 등록

FIRST-SERVICE
SECOND-SERVICE

즉

• first-service
• second-service

인스턴스가 표시되면 Eureka Client 등록 성공

---

🧠 TIL (Today I Learned)

• Spring Cloud Eureka는 마이크로서비스 환경에서 서비스 등록 및 위치 조회 관리
• 서비스 인스턴스는 Eureka Server에 자동 등록
• 서비스 호출 시 Eureka를 통해 서비스 위치 조회 가능
• RestTemplate 대신 Feign Client 기반 서비스 호출 가능
• Health Check 기반 장애 서비스 자동 제외 가능