📖 개요

• Eureka

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

• OpenFeign

다른 서비스를 HTTP로 호출할 때 인터페이스 기반으로 사용할 수 있는 선언형 REST Client

• 왜 사용하는지

마이크로서비스 환경에서는
하나의 서비스가 여러 인스턴스로 실행될 수 있음

이 경우

• 서비스 확장 시 IP / Port 관리 어려움
• 장애 발생 시 특정 서버로 요청 집중 가능
• 서비스 위치 변경 시 호출 실패 가능

Eureka를 사용하면

• 서비스 실행 시 자동으로 서버에 등록
• 다른 서비스는 서비스 이름으로 위치 조회 가능

FeignClient를 사용하면

• RestTemplate 없이
• 인터페이스 기반으로 다른 서비스 호출 가능

즉
서비스 위치 관리 + 서비스 간 호출을 단순화할 수 있음

• 해결하는 문제

• 서비스 위치 관리 문제 해결

• 서비스 인스턴스 확장 대응

• 서비스 간 HTTP 호출 코드 단순화

• 로드밸런싱 지원

⚙️ 핵심 개념

1️⃣ Eureka Server

서비스 등록 정보를 관리하는 중앙 서버 역할 수행

예시 구성

• Eureka Server 1개
• Order Service 인스턴스 1개
• Product Service 인스턴스 3개

Product Service를 3개 실행하면
Eureka에는 동일 서비스 이름으로 3개의 인스턴스 등록 처리

---

2️⃣ Eureka Client

각 서비스가 실행될 때
Eureka Server에 자신의 위치 등록

예시

• order-service
• product-service

각 서비스는 실행 시 Eureka에 등록되고
다른 서비스는 Eureka를 통해 위치 조회 가능

---

3️⃣ OpenFeign

다른 서비스를 호출할 때
인터페이스 선언만으로 REST 호출 처리

직접 URL을 조합하지 않고
서비스 이름 기반 호출 처리

FeignClient는 Eureka와 연동하여
등록된 서비스 인스턴스 목록을 조회하고 호출 수행

---

4️⃣ 클라이언트 사이드 로드밸런싱

FeignClient는 서비스 호출 시
여러 인스턴스 중 하나를 선택하여 요청 전달

즉

Order Service → Eureka 조회 → Product Service 인스턴스 선택 → 호출

여러 인스턴스가 존재할 경우
기본적으로 Round Robin 방식으로 요청 분배

Round Robin

• 요청을 순서대로 각 서버에 분배하는 방식
• 특정 서버에 트래픽이 집중되는 것을 방지

---

5️⃣ 서비스 실행 순서

Product Service가 Order Service보다 먼저 실행되는 것이 안정적

이유

• Order Service에서 Product Service 호출 시 오류 발생 가능
• 대상 서비스가 아직 등록되지 않았을 수 있음
• Eureka 등록 전 호출 시 연결 실패 가능

따라서

Product Service 실행 → Order Service 실행 순서 권장

🔍 동작 원리

전체 흐름

Client → Order Service → FeignClient → Eureka 조회 → Product Service

세부 흐름

1. Product Service 실행
2. Product Service가 Eureka Server에 등록
3. Product Service 인스턴스를 여러 개 실행하면 각각 등록
4. Order Service 실행
5. Order Service도 Eureka Server에 등록
6. Order Service 내부에서 FeignClient로 product-service 호출
7. Eureka가 등록된 Product 인스턴스 목록 반환
8. LoadBalancer가 호출 대상 인스턴스 선택
9. Product Service 응답 반환
10. Order Service가 최종 응답 반환

아키텍처 흐름

Client
→ Order Service
→ Eureka Server
→ Product Service

Product Service 인스턴스

• Product Service #1
• Product Service #2
• Product Service #3

🚀 실습 구성

서비스 구성

• Eureka Server : 1개
• Order Service : 1개
• Product Service : 3개

Product Service는 동일한 애플리케이션을
다른 포트로 실행하여 3개의 인스턴스 구성

예시 포트

• 19092
• 19093
• 19094

Order Service 호출

http://localhost:19091/order/1

요청을 여러 번 호출하면
응답 포트가 변경되는 것을 확인 가능

이를 통해 Round Robin 로드밸런싱 동작 확인

💻 코드 예시

1️⃣ Eureka Server

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {

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

---

2️⃣ Product Service

@SpringBootApplication
@EnableDiscoveryClient
public class ProductApplication {

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

---

3️⃣ Order Service

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class OrderApplication {

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

---

4️⃣ Product Controller

@RestController
@RequestMapping("/products")
public class ProductController {

    @Value("${server.port}")
    private String serverPort;

    @GetMapping("/{id}")
    public String getProduct(@PathVariable Long id) {
        return "Product " + id + " info!!!! From port : " + serverPort;
    }
}

각 Product 인스턴스는
자신이 실행된 포트 번호를 함께 반환

이를 통해 어떤 인스턴스가 응답했는지 확인 가능

---

5️⃣ FeignClient 인터페이스

@FeignClient(name = "product-service")
public interface ProductFeignClient {

    @GetMapping("/products/{id}")
    String getProduct(@PathVariable("id") Long id);
}

---

6️⃣ Order Controller

@RestController
@RequestMapping("/orders")
@RequiredArgsConstructor
public class OrderController {

    private final ProductFeignClient productFeignClient;

    @GetMapping("/{id}")
    public String getOrder(@PathVariable Long id) {
        return productFeignClient.getProduct(id);
    }
}

⚙️ yml 설정

1️⃣ Eureka Server

server:
  port: 8761

spring:
  application:
    name: eureka-server

eureka:
  client:
    register-with-eureka: false
    fetch-registry: false

---

2️⃣ Product Service

spring:
  application:
    name: product-service

server:
  port: 19092

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka

Product Service는
같은 애플리케이션을 여러 포트로 실행하여
여러 인스턴스를 구성 가능

예시

• 19092
• 19093
• 19094

---

3️⃣ Order Service

spring:
  application:
    name: order-service

server:
  port: 19091

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka

⚙️ application.yml 사용하는 이유

1️⃣ 계층 구조 표현

yml은 들여쓰기 기반으로
설정의 계층 구조 표현 가능

예시

spring:
  application:
    name: product-service

properties라면

spring.application.name=product-service

---

2️⃣ 설정 가독성

설정이 많아질수록
yml이 구조 파악이 쉬움

특히 다음 설정이 많을 때 유리

• Eureka
• Security
• DB
• Cloud
• Management

---

3️⃣ properties도 사용 가능

Spring Boot는

• application.yml
• application.properties

둘 다 지원

즉 properties를 못 쓰는 것이 아니라
설정 관리 편의성 때문에 yml을 더 많이 사용

---

4️⃣ yml 사용 시 주의사항

yml은 공백 기반 문법

보통 2칸 들여쓰기 사용

예시

spring:
  application:
    name: order-service

탭 대신 공백 사용 권장

🧠 TIL (Today I Learned)

• Eureka를 사용하면 서비스 주소(IP / Port)를 직접 관리하지 않아도 됨
• FeignClient는 인터페이스 기반으로 다른 서비스 호출 가능
• 동일 서비스 여러 인스턴스 실행 시 로드밸런싱 처리 가능
• 응답 포트를 반환하면 어떤 인스턴스가 처리했는지 확인 가능
• Round Robin 방식으로 요청이 여러 인스턴스에 분산됨
• application.yml은 설정 구조 표현에 유리