İngilizce dilinde oku

Aracılığıyla paylaş

Uygulama Yapılandırma Hizmetini yönetilen Spring Cloud Config Server'a geçirme

  • Makale

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

Bu makale şunlar için geçerlidir: ❎ Temel/Standart ✅ Kurumsal

Bu makalede, Java uygulamalarıyla Azure Spring Apps Kurumsal planı kullanılırken Uygulama Yapılandırma Hizmeti'nden (ACS) Spring Cloud Config Server'a nasıl geçiş yapılır açıklanmaktadır.

Spring Cloud Config Server, uygulamaların Git depoları gibi dış kaynaklardan yapılandırma özelliklerini getirmek için kullanabileceği merkezi bir yapılandırma hizmeti sağlar.

Spring Cloud Config Server sağlama

Uygulama Yapılandırma Hizmeti'nin etkinleştirildiği bir Azure Spring Apps Kurumsal plan örneğiniz varsa, ACS'den Spring Cloud Config Server'a geçmenin ilk adımı Azure Spring Apps ortamınızda Yapılandırma Sunucusu'nu sağlamaktır. Azure portalını veya Azure CLI'yi kullanarak sağlayabilirsiniz.

Spring Cloud Config Server'ı sağlamak için aşağıdaki adımları kullanın:

  • Azure portalında Azure Spring Apps kurumsal örneğinize gidin.
  • Menüde Spring Cloud Config Server'ı seçin.
  • Spring Cloud Config Server'ın etkinleştirilip etkinleştirilmediğini görmek için Yönet'i seçin. Değilse, etkinleştirin ve ardından kaydetmek için Uygula'yı seçin.
  • Başarıyla güncelleştirdikten sonra Genel Bakış sekmesinde Yapılandırma sunucusunun Sağlama Durumu Başarılıolduğunu görebilirsiniz.

Spring Cloud Config Server'ı yapılandırma

Spring Cloud Config Server'ı sağladıktan sonra, sonraki adım sorunsuz bir geçiş sağlamak için bunu uygulamanız için yapılandırmaktır.

Azure portalında Spring Cloud Config Server'ı yapılandırmak için aşağıdaki adımları kullanın:

  1. Azure Spring Apps örneğinizde Spring Cloud Config Server'a gidin.

  2. Ayarlar sekmesinde, ACS'nin tüm depolarının yapılandırmalarını Spring Cloud Config Server ile eşleyin.

    ACS'de yalnızca bir deponuz varsa, ad ve desenler olmadan Spring Cloud Config Server için varsayılan depoya eşleyin. ACS'de birden çok deponuz varsa Spring Cloud Config Server için varsayılan depo olarak bir depo seçin ve diğerlerini ek depo olarak kullanın. , , label, search pathnameve authentication gibi uriözellikleri ACS'den Spring Cloud Config Server'a geçirin.

    Spring Cloud Config Server sayfasını gösteren Azure portalının ekran görüntüsü.

  3. Yapılandırmaları eşledikten sonra, yapılandırmayı doğrulamak için Doğrula'yı seçin.

  4. Doğrulama başarılı olduktan sonra Spring Cloud Config Server yapılandırmasını tamamlamak için Uygula'yı seçin.

  5. Değişiklikleri uygulamak için Uygulama bağlama sekmesinde Uygulamayı bağla'yı ve ardından Spring Cloud Config Server'ı kullanmak için tüm uygulamaları seçin.

ACS özelliğini pattern geçirmek için uygulamanızın Azure Spring Apps adının Git deposundaki yapılandırma dosyası adıyla eşleştiğinden emin olmak önemlidir.

  • Azure Spring Apps'in uygulama adı yapılandırma dosyasının dosya adıyla eşleşiyorsa Spring Cloud Config Server, ek yapılandırma gerektirmeden uygulama için eşleşen ada sahip yapılandırma dosyasını otomatik olarak uygular.
  • Adlar eşleşmiyorsa, yapılandırma dosyası adı olarak adıyla yeni bir uygulama oluşturmanız gerekir.

Daha fazla yapılandırma için bkz . Spring Cloud Config Server belgesi.

Uygulama yapılandırmanızı güncelleştirme

ACS ile Yapılandırma Sunucusu arasındaki uygulama mekanizmalarındaki farklılıklar nedeniyle, yapılandırmaların getiriliş biçimine uyum sağlamak için bazı uygulama yapılandırma değişiklikleri gereklidir.

Spring Cloud Config Server'ı sağladıktan ve yapılandırdıktan sonra aşağıdaki adımları kullanarak yapılandırmanızı ayarlamanız gerekir:

  1. Maven için pom.xml dosyanıza veya Gradle için build.gradle dosyanıza aşağıdaki gerekli Spring Cloud Config bağımlılıklarını ekleyerek Spring Boot bağımlılıklarını güncelleştirin.

    XML 
    <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>

  2. Profili yapılandırın.

    ACS'de profili bir Azure Spring Apps dağıtımında desenler olarak sağlarken Spring Cloud Config Server'da profili uygulamanın kaynak kodunda yapılandırabilirsiniz.

    Spring Cloud Config Server'ın ortama özgü yapılandırmalara hizmet edebilmesi için uygulamanızın doğru profilleri ( dev, prodvb.) kullandığından emin olun.

    Aşağıdaki örnekte gösterildiği gibi, uygulamanızdaki bootstrap.yml veya application.yml dosyasını Spring Cloud Config Server'a işaret eden doğru yapılandırma özellikleriyle güncelleştirin:

    YAML 
    spring:
  cloud:
    config:
      profile: dev

    Azure Spring Apps'in uygulama adının git deponuzdaki yapılandırma dosyası adıyla eşleştiğinden emin olun. Ayrıca, uygulamanızın kodunda yapılandırmaktan spring.application.name kaçının.

Uygulamayı yeniden dağıtma

Uygulamayı yerel olarak test ettikten sonra, aşağıdaki Azure CLI komutunu kullanarak Azure Spring Apps'te Spring Cloud Config Server'ı kullanmak üzere yeniden dağıtabilirsiniz:

Azure CLI 
az spring app deploy \
    --name <app-name> \
    --artifact-path <path-to-your-app> \
    --config-file-patterns '""'

parametresiyle --config-file-patterns '""' uygulamanızdan Application Configuration Service başvurusunu temizler. Uygulama, yapılandırmayı Uygulama Yapılandırma Hizmeti yerine Spring Cloud Config Server üzerinden tüketir.

Uygulama Yapılandırma Hizmetini Devre Dışı Bırak

Tüm uygulamalar Spring Cloud Config Server'a geçişi tamamladıktan sonra, bu uygulamaların bağlamasını Uygulama Yapılandırma Hizmeti'ne açabilir ve ACS'yi devre dışı bırakabilirsiniz.

  1. Azure Spring Apps örneğinizde Uygulama Yapılandırma Hizmeti'ne gidin
  2. Uygulama bağlama sekmesini açın, ardından bağlamasını kaldıracak her ilişkili uygulamayı seçin.
  3. Tüm uygulamalar ilişkisiz olduktan sonra Yönet'i seçerek Uygulama Yapılandırma Hizmetini devre dışı bırakın.

Bu adımları dikkatle izleyerek sorunsuz bir geçiş sağlayabilir ve Azure Spring Apps'te Spring Cloud Config Server'ın avantajlarını kullanabilirsiniz.

Bilinen sınırlama

ACS'nin Spring Cloud Config Server'a geçirilmesi yalnızca Java uygulamaları için geçerlidir çünkü ACS yapılandırmayı Kubernetes-native ConfigMapkullanarak yönetir. Bu yöntem Kubernetes ortamlarında dinamik yapılandırma güncelleştirmelerini etkinleştirir ve birden çok programlama diline sahip farklı uygulamalar için çok yönlü hale getirir. Spring Cloud Config Server öncelikli olarak Spring Framework özellikleri kullanılarak Java uygulamaları için tasarlanmıştır, bu nedenle yalnızca Java için yapılandırma yönetimini destekler.