📖 개요

Spring Cloud Config
분산 시스템 환경에서 애플리케이션 설정을 중앙에서 관리하는 구성 관리 서버

• 마이크로서비스 환경에서 설정 중앙 관리 가능
• 환경별(local, dev, qa, prod 등) 설정 분리 지원
• 설정 변경 시 재배포 없이 반영 가능

왜 사용하는지

• 서비스 증가 시 설정 관리 복잡도 증가
• DB, API, 포트 설정이 서비스마다 분산됨
• 설정 변경 시 일괄 관리 어려움 발생

해결하는 문제

• 설정 파일 중앙 관리
• 환경별 설정 분리
• 설정 변경 반영 방식 통일

---

⚙️ 핵심 개념

1️⃣ Config Server

설정 파일을 저장하고 제공하는 서버 역할 수행
중앙 저장소 역할 담당

@SpringBootApplication
@EnableConfigServer
public class ConfigApplication {

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

2️⃣ Config Client

각 서비스는 Config Server에서 설정을 가져와서 사용

spring:
  application:
    name: product-service
  config:
    import: "configserver:"
  cloud:
    config:
      discovery:
        enabled: true
        service-id: config-server

• 서비스 이름 기준 설정 매칭
• Config Server에서 설정 조회 후 적용

3️⃣ 환경별 프로필 관리

환경별 설정 파일 분리 가능

product-service.yml
product-service-local.yml
product-service-dev.yml
product-service-qa.yml
product-service-prod.yml

spring:
  profiles:
    active: local

• active 값으로 환경 선택
• application name + profile 기준 설정 로드

※ 프로필 이름은 고정 규칙이 아닌 팀 정책에 따라 구성
(local, dev, qa, staging, prod 등)

4️⃣ 설정 갱신 방식

설정 변경 후 반영 방식

• /actuator/refresh 호출 → 수동 갱신
• Spring Cloud Bus → 자동 갱신

이번 구성에서는 수동 갱신 방식 사용

---

🔍 동작 원리

Client Service → Eureka → Config Server → 설정 파일 조회 → Client 적용

실행 흐름

Product Service 실행
→ Eureka 등록
→ Config Server 위치 조회
→ product-service-local.yml 로드
→ 설정 적용

설정 변경 흐름

설정 파일 수정
→ Config Server 반영
→ /actuator/refresh 호출
→ 설정 재적용

구조

Eureka Server → Config Server → Product Service

---

💻 코드 예시

1️⃣ Config Server 설정

server:
  port: 18080

spring:
  profiles:
    active: native
  application:
    name: config-server
  cloud:
    config:
      server:
        native:
          search-locations: classpath:/config-repo

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

• native 모드 사용 → 로컬 파일 기반 설정 제공

2️⃣ Config Client 설정

server:
  port: 0

spring:
  profiles:
    active: local
  application:
    name: product-service
  config:
    import: "configserver:"
  cloud:
    config:
      discovery:
        enabled: true
        service-id: config-server

management:
  endpoints:
    web:
      exposure:
        include: refresh

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

3️⃣ 설정 파일 예시

# product-service.yml
server:
  port: 19093
message: "product-service message"

# product-service-local.yml
server:
  port: 19083
message: "product-service-local message"

4️⃣ 설정 값 조회 API

@RefreshScope
@RestController
@RequestMapping("/product")
public class ProductController {

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

    @Value("${message}")
    private String message;

    @GetMapping
    public String getProduct() {
        return "Product detail from PORT : " + serverPort + " and message : " + message;
    }
}

• @RefreshScope 사용 → 설정 변경 후 재반영 가능

---

🚀 사용 사례

• DB 연결 정보 환경별 분리
• 외부 API URL 관리
• 공통 설정 중앙 관리
• 운영 환경 설정 변경 대응
• feature flag 관리

---

🧠 TIL (Today I Learned)

Spring Cloud Config 사용 시 설정 중앙 관리 가능
application name + profile 기준으로 환경별 설정 분리
native 모드로 로컬 환경 구성 가능
/actuator/refresh 호출로 수동 설정 갱신 처리
프로필 이름은 팀 정책에 따라 자유롭게 구성 가능