# Spring Cloud Config

**Spring Cloud Config**는 분산 시스템에서 외부화된 설정을 관리하기 위한 서버 및 클라이언트 프레임워크입니다. 마이크로서비스 아키텍처(MSA) 환경에서 수백, 수천 개의 서비스 인스턴스에 대한 설정 파일을 중앙에서 집중적으로 관리하고 버전 관리를 지원함으로써 운영 효율성과 일관성을 높이는 데 핵심적인 역할을 합니다.

## 개요

현대 클라우드 네이티브 애플리케이션은 복잡한 구성 파라미터(데이터베이스 연결 정보, API 키, 기능 플래그 등)를 필요로 합니다. 전통적인 방식에서는 이러한 설정이 애플리케이션의 JAR 파일 내부에 하드코딩되거나 개별 서버의 프로퍼티 파일에 분산되어 저장되었습니다. 이는 설정 변경 시 모든 인스턴스를 재배포하거나 수동으로 업데이트해야 하는 번거로움을 초래했습니다.

Spring Cloud Config는 이러한 문제를 해결하기 위해 설계되었습니다. 설정 정보를 Git, SVN, 파일 시스템 등 다양한 저장소에 보관하고, HTTP API를 통해 클라이언트(스프링 부트 애플리케이션)가 설정을 가져오도록 합니다. 이를 통해 설정의 변경 사항을 실시간으로 반영하고, 환경별(개발, 테스트, 운영)로 다른 설정을 용이하게 적용할 수 있습니다.

## 주요 특징

Spring Cloud Config는 다음과 같은 핵심 기능을 제공합니다.

*   **중앙 집중식 설정 관리**: 모든 마이크로서비스의 설정을 단일 저장소에서 관리하여 일관성을 유지합니다.
*   **다양한 백엔드 지원**: 기본적으로 Git 저장소를 지원하며, SVN, 파일 시스템, JDBC 등 다양한 저장소를 백엔드로 사용할 수 있습니다.
*   **환경별 프로필 지원**: `application.yml` 파일에 `dev`, `prod`, `staging` 등의 프로필을 구분하여 저장하고, 실행 시점에 활성화된 프로필에 맞는 설정을 로드합니다.
*   **암호화/복호화 지원**: 민감한 정보(비밀번호, 키 등)를 저장할 때 평문 대신 암호화된 형태로 저장하고, 클라이언트에서 자동으로 복호화하여 사용할 수 있습니다.
*   **Spring Boot Actuator 통합**: 설정 서버의 상태 확인, 설정 갱신 요청 등을 위한 엔드포인트를 제공합니다.

## 아키텍처 및 구성 요소

Spring Cloud Config는 크게 **Config Server**와 **Config Client**로 구성됩니다.

### 1. Config Server (설정 서버)

설정 서버는 설정 정보를 제공하는 중앙 서버입니다. Spring Boot 애플리케이션으로 구현되며, `spring-cloud-config-server` 의존성을 추가하여 활성화합니다.

*   **작동 원리**: 클라이언트의 요청에 따라 백엔드 저장소(Git 등)에서 설정 파일을 읽어옵니다.
*   **로컬 캐싱**: 성능 향상을 위해 설정 정보를 로컬에 캐싱하며, 필요시 Git 저장소와 동기화합니다.
*   **보안**: 설정 서버는 일반적으로 내부 네트워크에 위치하며, Spring Security를 통해 접근 권한을 제어하는 것이 권장됩니다.

### 2. Config Client (설정 클라이언트)

설정 클라이언트는 설정 정보를 필요로 하는 마이크로서비스 애플리케이션입니다.

*   **작동 원리**: 애플리케이션 시작 시 Config Server에 연결하여 설정을 다운로드합니다.
*   **동적 갱신**: `@RefreshScope` 어노테이션을 적용한 빈은 설정이 변경될 때 자동으로 재초기화되어 실시간으로 설정을 반영합니다.
*   **로딩 순서**: 스프링 부트의 일반적인 프로퍼티 로딩 순서보다 먼저 설정을 로드하여, 애플리케이션의 초기화 과정에 영향을 줄 수 있는 설정(예: 데이터베이스 연결 정보)을 우선적으로 적용합니다.

## 설정 서버 구축 방법

Spring Cloud Config Server를 구축하기 위해서는 다음과 같은 단계가 필요합니다.

### 1. 의존성 추가

`build.gradle` 또는 `pom.xml`에 `spring-cloud-config-server` 의존성을 추가합니다.

```groovy
dependencies {
    implementation 'org.springframework.cloud:spring-cloud-config-server'
    // 보안 및 모니터링을 위해 추가
    implementation 'org.springframework.boot:spring-boot-starter-security'
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
}
```

### 2. 애플리케이션 설정

`application.yml` 파일에서 Git 저장소 경로를 설정합니다.

```yaml
server:
  port: 8888

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-org/config-repo.git
          search-paths: '{application}'
          username: your-username
          password: your-password
          default-label: main
```

### 3. 활성화

주요 애플리케이션 클래스에 `@EnableConfigServer` 어노테이션을 추가하여 설정 서버 기능을 활성화합니다.

```java
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;

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

## 설정 클라이언트 연동

클라이언트 애플리케이션은 `bootstrap.yml` (또는 `bootstrap.properties`) 파일을 사용하여 Config Server의 주소를 지정합니다. `bootstrap.yml`은 `application.yml`보다 먼저 로드되므로, 애플리케이션의 초기 설정에 필수적입니다.

```yaml
# bootstrap.yml
spring:
  application:
    name: my-service
  cloud:
    config:
      uri: http://localhost:8888
      fail-fast: true
      retry:
        initial-interval: 1000
        max-attempts: 3
```

## 설정 파일 구조 및 매핑 규칙

Config Server는 Git 저장소 내의 파일 구조에 따라 설정을 매핑합니다. 일반적인 URL 패턴은 다음과 같습니다.

`/{application}/{profile}[/{label}]`

*   **application**: 서비스 이름 (예: `user-service`)
*   **profile**: 환경 프로필 (예: `dev`, `prod`)
*   **label**: Git 브랜치 또는 태그 (예: `main`, `v1.0`)

예를 들어, `http://localhost:8888/user-service/dev`로 요청하면 Git 저장소 내의 `user-service-dev.yml` 파일을 반환합니다. 만약 해당 파일이 없으면 `user-service.yml` 파일을 기본값으로 사용합니다.

## 동적 설정 갱신

설정 변경 사항을 실시간으로 적용하기 위해 클라이언트 애플리케이션에 `@RefreshScope`를 사용해야 합니다.

1.  **의존성 추가**: `spring-cloud-starter-bus-amqp` (RabbitMQ/Kafka 사용 시) 또는 `spring-cloud-starter-bus-kafka` 의존성을 추가하여 이벤트 브로커와 연동합니다.
2.  **엔드포인트 호출**: 설정 서버의 `/actuator/refresh` 엔드포인트를 호출하거나, 이벤트 브로커를 통해 `RefreshEvent`를 발행합니다.
3.  **빈 재초기화**: `@RefreshScope`가 붙은 빈이 새로운 설정으로 재초기화됩니다.

> **주의**: `@RefreshScope`는 모든 빈에 적용하면 안 됩니다. 설정 변경 시 재초기화가 필요한 빈(예: 데이터소스, HTTP 클라이언트)에만 적용해야 합니다. 일반적인 서비스 로직은 재초기화할 필요가 없으며, 오히려 성능 저하를 유발할 수 있습니다.

## 보안 고려사항

설정 서버는 민감한 정보를 포함할 수 있으므로 보안이 매우 중요합니다.

*   **HTTPS 사용**: 설정 서버와의 통신은 반드시 HTTPS를 통해 암호화해야 합니다.
*   **인증 및 권한 부여**: Spring Security를 사용하여 설정 서버에 접근할 수 있는 사용자를 제한합니다.
*   **Git 저장소 보안**: Git 저장소의 접근 권한을 철저히 관리하고, 민감한 정보는 절대 평문으로 저장하지 않습니다.
*   **암호화**: `spring-cloud-config-server`는 Jasypt를 기반으로 한 암호화 기능을 내장하고 있습니다. `encrypt.key` 프로퍼티를 설정하여 민감한 값을 암호화할 수 있습니다.

## 관련 문서 및 참고 자료

*   [Spring Cloud Config 공식 문서](https://docs.spring.io/spring-cloud-config/docs/current/reference/html/)
*   [Spring Boot Actuator 문서](https://docs.spring.io/spring-boot/docs/current/reference/html/actuator.html)
*   [Git 저장소 기반 설정 관리 가이드](https://spring.io/guides/gs/config-server/)

## 결론

Spring Cloud Config는 마이크로서비스 아키텍처에서 설정 관리의 복잡성을 해결하는 강력한 도구입니다. Git과의 통합을 통해 버전 관리와 롤백이 용이하며, Spring 생태계와의 긴밀한 통합으로 빠른 구축과 유지보수가 가능합니다. 다만, 대규모 분산 시스템에서는 설정 서버의 단일 장애점(SPOF) 문제를 고려하여 고가용성 구성(HA)과 부하 분산을 함께 고려하는 것이 중요합니다.