Spring Cloud Config

cloud.spring.io/spring-cloud-config/reference/html/#_quick_start

Spring Cloud Config

spring.io/projects/spring-cloud-config#overview

Spring Cloud Config

 

스프링 클라우드 컨피그는 분산 시스템 안에서 외부화된 구성(Configuration)을 위한 서버 사이브와 클라이언트 사이드를 지원합니다. Config Server로 여러분은 모든 환경에서 애플리케이션의 외부 속성을 관리 할 수 있는 중심(편리한) 장소를 가질 수 있습니다. 클라이언트와 서버의 개념은 Spring Environment와 PropertySource 추상화와 동일하게 매핑됩니다. 따라서 Spring 애플리케이션과 매우 잘 맞지만 어떤한 언어로 실행되든 모든 애플리케이션과 함께 사용할 수 있습니다. 애플리케이션은 베포 파이프라인을 통해 개발에서 테스트 및 프로덕션으로 이동함에 따라, 여러분은 이러한 환경 간의 구성을 관리하고 애플리케이션이 마이그레이션 할 때 실행하는 데 필요한 모든 것을 갖추고 있는지 확인할 수 있습니다. 서버 스토리지 백엔드의 기본 구현은 git을 사용합니다 . 따라서 레이블이 지정된 구성 환경 버전을 쉽게 지원할뿐만 아니라 컨텐츠 관리를 위한 다양한 도구에 액세스 할 수 있습니다.대체 구현을 추가하고 이를 Spring Configuration으로 연결하는 것은 쉽습니다.

 

Quick Start

이 빠른 시작(Quick Start)은 스프링 클라우드 컨피그 서버의 서버와 클라이언트를 모두 사용하는 방법을 안내합니다.

 

...

 

Property 소스를 찾는 디폴트 전략은 git 저장소(spring.cloud.config.server.git.uri)를 복제하고 이를 사용하여 mini SpringApplication을 초기화하는 것 입니다. mini SpringApplication의 Enviroment는 property 소스를 열거하고 이를 JSON 엔드 포인트에 게시하는 데 사용됩니다. 

 

...

 

여기서 애플리케이션은 SpringApplication에서 spring.config.name으로 주입됩니다 (일반적으로 Spring Boot 앱에서는 일반적으로 애플리케이션 임). profile은 활성 프로필 (또는 쉼표로 구분 된 속성 목록)이고 label은 선택적 git 레이블 (기본값은 master)입니다.

 

Spring Cloud Config Server는 다양한 소스에서 원격 클라이언트에 대한 구성을 가져옵니다. 다음 예제는 git 저장소 (제공되어야 함)에서 구성을 가져옵니다.

 

YAML

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo

 

기타 소스는 JDBC 호환 데이터베이스, Subversion, Hashicorp Vault, Credhub 및 로컬 파일 시스템입니다.

 

Client-Side Usage

애플리케이션에서 이러한 기능을 사용하려면이를 spring-cloud-config-client에 의존하는 Spring Boot 애플리케이션으로 빌드 할 수 있습니다 (예 : config-client 또는 샘플 애플리케이션에 대한 테스트 케이스 참조). 종속성을 추가하는 가장 편리한 방법은 Spring Boot 스타터 org.springframework.cloud:spring-cloud-starter-config를 사용하는 것입니다. Maven 사용자를 위한 부모 pom 및 BOM (spring-cloud-starter-parent)과 Gradle 및 Spring CLI 사용자를 위한 Spring IO 버전 관리 속성 파일도 있습니다.

 

...

 

이 HTTP 서버가 실행되면 포트 8888의 디폴터 로컬 구성 서버 (실행중인 경우)에서 외부 구성을 선택합니다. 시작 동작을 수정하려면 bootstrap.properties를 사용하여 구성 서버의 위치를 ​​변경할 수 있습니다 (application.properties와 유사하지만 애플리케이션 컨텍스트의 부트 스트랩 단계 용).

 

...

 

기본적으로 애플리케이션 이름이 설정되지 않은 경우 application이 사용됩니다. 이름을 수정하기 위해 다음 속성을 bootstrap.properties 파일에 추가 할 수 있습니다.

 

...

 

bootstrap properties는  /env 엔드포인트에 높은 우선 순위 property 소스로 표시됩니다.

 

...

 

Spring Cloud Config Server

 

 

...

Spring Cloud Config Client

스프링 부트 애플리케이션은 스프링 컨픽 서버( 또는 응용 프로그램 개발자가 제공 한 기타 외부 속성 소스 )의 이점을 즉시 취 할 수 있습니다. 또한 Environment 변경 이벤트와 관련된 몇 가지 추가 유용한 기능을 선택 할 수 있습니다.

 

Config First Bootstrap

클래스 경로에 Spring Cloud Config Client가 있는 모든 애플리케이션의 기본 동작은 다음과 같습니다. 구성 클라이언트가 시작되면 구성 서버에 바인딩하고 (spring.cloud.config.uri 부트스트랩 구성 속성을 통해) 원격 속성 소스로 Spring Environment을 초기화합니다.

 

이 동작의 최종 결과는 구성 서버를 사용하려는 모든 클라이언트 애플리케이션에 spring.cloud.config.uri에 설정된 서버 주소 (기본값은 "http:localhost : 8888"/)가 있는 bootstrap.yml (또는 환경 변수)가 필요하다는 것입니다.

 

Discovery First Bootstrap

만약 여러분이 (Spring Cloud Netflix 및 Eureka Service Discovery 또는 Spring Cloud Consul과 같은) DiscoveryClinet 구현체를 사용한다면 Config 서버가 Discovery 서비스에 등록되도록 할 수 있습니다. 그러나 디폴트 "Config First" 모드에서, 클라이언트는 등록의 이점을 취할 수 없습니다.

 

DiscoveryClient를 사용하여 구성 서버를 찾으려면 spring.cloud.config.discovery.enabled = true (기본값은 false)로 설정하면 됩니다. 이렇게하면 클라이언트 애플리케이션은 적절한 discovery 구성과 함께 bootstrap.yml ( 또는 환경 변수 )이 필요합니다. 예를 들어 Spring Cloud Netflix에서는 Eureka 서버 주소를 정의해야합니다 (예:eureka.client.serviceUrl.defaultZone).이 옵션을 사용하기 위한 가격은 시작 시에 서비스 등록을 찾기 위한 추가 네트워크 왕복비 입니다. 이 이점은 Discovery Service가 고정 된 지점인 한 Config Server가 좌표를 변경할 수 있다는 것 입니다. 디폴트 서비스 ID는 configserver 이지만 spring.cloud.config.discovery.sericeId를 설정하여 클라이언트에서 변경할 수 있습니다. ( 그리고 서버에서 서비스를 위한 일반적인 방법은 spring.application.name으로 설정할 수 있습니다. )

 

...

 

---

 

github.com/victorherraiz/cloud-config-client

victorherraiz/cloud-config-client