Spring Boot Config Server, dağıtılmış uygulamalar için merkezi yapılandırma yönetimi sağlar ve hizmetlerin yeniden başlatılmasına gerek kalmadan dinamik yapılandırma güncellemelerine olanak tanır. Bu kılavuz, Spring Boot Config Server'ı nasıl kuracağınızı ve etkin bir şekilde kullanacağınızı açıklar.
Bu bölümde Neden Config Server Kullanmalıyız? konusunu netleştirip uygulamada kullanacağınız temel noktaları özetliyoruz.
Aşağıdaki bileşenlerin sisteminizde yüklü olduğundan emin olun:
Spring Cloud Config Server için gerekli bağımlılıkları ekleyin.
Maven:
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-config-server</artifactId> </dependency>
Gradle:
implementation 'org.springframework.cloud:spring-cloud-config-server'
Config ayarlarını saklamak için Git deposunu belirten bir application.yml dosyası oluşturun.
server: port: 8888 spring: cloud: config: server: git: uri: https://github.com/example/config-repo default-label: main
Not:
https://github.com/example/config-repoadresini kendi Git deponuzla değiştirin.
Git deposunda (config-repo) bir application.yml dosyası oluşturun:
config.key: 'Merhaba, Config Server!'
Dosyayı ekleyip gönderin:
git add application.yml git commit -m "Konfigürasyon dosyası eklendi" git push origin main
Config Server uygulamasını başlatın:
./mvnw spring-boot:run
veya Gradle kullanarak:
gradle bootRun
Config Server'ın çalıştığını doğrulamak için şu komutu çalıştırın:
curl -X GET http://localhost:8888/application/default
Beklenen Çıktı:
{ "name": "application", "profiles": ["default"], "propertySources": [ { "name": "https://github.com/example/config-repo/application.yml", "source": { "config.key": "Merhaba, Config Server!" } } ] }
Bu bölümde Adım 5: İstemci Uygulamayı Yapılandırma konusunu netleştirip uygulamada kullanacağınız temel noktaları özetliyoruz.
Bu adımda istemcinin Config Server üzerinden merkezi ayarları çekebilmesi için gerekli starter bağımlılığını ekliyoruz.
Maven:
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-config</artifactId> </dependency>
Gradle:
implementation 'org.springframework.cloud:spring-cloud-starter-config'
İstemci uygulamanın bootstrap.yml dosyasına aşağıdaki ayarları ekleyin:
spring: application: name: config-client cloud: config: uri: http://localhost:8888
Aşağıdaki örnek, İstemci Uygulama Kodu için pratik bir bağlam sunar ve doğrudan uygulanabilir.
İstemci uygulamasını başlatmak için:
./mvnw spring-boot:run
veya Gradle kullanarak:
gradle bootRun
Config Server'dan konfigürasyonu almak için:
curl -X GET http://localhost:8080/config
Beklenen Çıktı:
Konfigürasyon Değeri: Merhaba, Config Server!
Artık Spring Boot Config Server için üretim odaklı bir Spring Boot temeliniz var. Sonraki adımda ayarları kendi domainine uyarlayıp test ve gözlemlenebilirlik katmanını ekleyerek gerçek trafik altında doğrulayın.
package com.example.configserver; 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); } }
package com.example.configserver import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication import org.springframework.cloud.config.server.EnableConfigServer @SpringBootApplication @EnableConfigServer class ConfigServerApplication fun main(args: Array<String>) { runApplication<ConfigServerApplication>(*args) }
package com.example.configclient; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.beans.factory.annotation.Value; @SpringBootApplication @RestController @RequestMapping("/config") public class ConfigClientApplication { @Value("${config.key:not found}") private String configValue; @GetMapping public String getConfigValue() { return "Konfigürasyon Değeri: " + configValue; } public static void main(String[] args) { SpringApplication.run(ConfigClientApplication.class, args); } }
package com.example.configclient import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication import org.springframework.web.bind.annotation.GetMapping import org.springframework.web.bind.annotation.RequestMapping import org.springframework.web.bind.annotation.RestController import org.springframework.beans.factory.annotation.Value @SpringBootApplication @RestController @RequestMapping("/config") class ConfigClientApplication { @Value("\${config.key:not found}") private lateinit var configValue: String @GetMapping fun getConfigValue(): String { return "Konfigürasyon Değeri: $configValue" } } fun main(args: Array<String>) { runApplication<ConfigClientApplication>(*args) }
