Spring Cloud Azure yapılandırması

Bu makalede tüm Spring Cloud Azure ortak yapılandırma özellikleri açıklanmaktadır.

Her Azure Hizmet SDK'sı için yapılandırma

Azure Hizmet SDK'larının çoğu aktarım türüne göre iki kategoriye ayrılabilir: HTTP tabanlı veya AMQP tabanlı. Kimlik doğrulama sorumluları ve Azure ortam ayarları gibi tüm SDK'lar için ortak olan veya HTTP isteklerini ve yanıtlarını günlüğe kaydetme düzeyi gibi HTTP tabanlı istemciler için ortak olan özellikler vardır. Spring Cloud Azure 4.0'dan başlayarak, her Azure hizmeti için belirtebileceğiniz beş yaygın yapılandırma özelliği kategorisi ekledik.

Aşağıdaki tabloda birden çok hizmet için ortak özellikler listelenmektedir:

Mülk	Açıklama
spring.cloud.azure.azure-service.client	Aktarım istemcilerini bir Azure hizmet SDK'sı altında yapılandırılır.
spring.cloud.azure.azure-service.credential	Bir Azure hizmet SDK'sı için Microsoft Entra Id ile kimlik doğrulamasını yapılandırılır.
spring.cloud.azure.azure-service.profile	Bir Azure hizmet SDK'sı için Azure bulut ortamını yapılandırılır.
spring.cloud.azure.azure-service.proxy	Bir Azure hizmet SDK'sı için ara sunucu seçeneklerini yapılandırılır.
spring.cloud.azure.azure-service.retry	Bir Azure hizmet SDK'sı için geçerli olan yeniden deneme seçeneklerini yapılandırılır. Yeniden deneme seçenekleri SDK'ların bir bölümünü destekler; spring.cloud.azure.cosmos.retry yoktur.

Yapılandırma özellikleri ön ekleri, yapılandırma özelliklerini daha tutarlı ve daha sezgisel hale getirmek için Spring Cloud Azure 4.0'dan bu yana spring.cloud.azure ad alanıyla birleştirildi. Aşağıdaki tabloda, desteklenen Azure hizmetleri için ön eklerin hızlı bir incelemesi sağlanmaktadır:

Azure hizmeti	Yapılandırma özelliği ön eki	Yapılandırma özellikleri bağlantısı
Azure Uygulama Yapılandırması	spring.cloud.azure.appconfiguration	Uygulama Yapılandırması yapılandırma özellikleri
Azure Cosmos DB veritabanı	bahar.cloud.azure.cosmos	Azure Cosmos DB yapılandırma özelliklerini
Azure Event Hubs	spring.cloud.azure.eventhubs	Event Hubs yapılandırma özelliklerini
Azure Key Vault Sertifikası	spring.cloud.azure.keyvault.certificate	Key Vault Sertifikaları yapılandırma özellikleri
Azure Key Vault Gizli Dizisi	spring.cloud.azure.keyvault.secret	Key Vault Gizli Dizileri yapılandırma özelliklerini
Azure Hizmet Otobüsü	spring.cloud.azure.servicebus	Service Bus yapılandırma özelliklerini
Azure Depolama Blobu	spring.cloud.azure.storage.blob	depolama blobu yapılandırma özelliklerini
Azure Depolama Dosya Paylaşımı	spring.cloud.azure.storage.fileshare	depolama dosya paylaşımı yapılandırma özelliklerini
Azure Depolama Kuyruğu	spring.cloud.azure.storage.queue	depolama kuyruğu yapılandırma özelliklerini

Azure Hizmet SDK'ları için genel yapılandırma

Azure Cosmos DB ve Azure Event Hubs'a erişmek için aynı hizmet sorumlusunu kullanmak gibi farklı Azure hizmetleri arasında paylaşabileceğiniz bazı özellikler vardır. Spring Cloud Azure 4.0, ad alanı spring.cloud.azuretüm Azure SDK'larına uygulanan özellikleri tanımlamanızı sağlar.

Aşağıdaki tabloda genel özellikler listelenir:

Mülk	Açıklama
spring.cloud.azure.client	Aktarım istemcilerini yapılandıran; varsayılan olarak tüm Azure SDK'ları için geçerlidir.
spring.cloud.azure.credential	Varsayılan olarak tüm Azure SDK'ları için Microsoft Entra Id ile kimlik doğrulamasını yapılandırır.
spring.cloud.azure.profile	Varsayılan olarak tüm Azure SDK'ları için Azure bulut ortamını yapılandırır.
spring.cloud.azure.proxy	Varsayılan olarak tüm Azure SDK istemcileri için geçerli olan ara sunucu seçeneklerini yapılandırılır.
spring.cloud.azure.retry dosyasını	Varsayılan olarak tüm Azure SDK istemcileri için geçerli olan yeniden deneme seçeneklerini yapılandırılır.

Not

Her Azure hizmeti altında yapılandırılan özellikler genel yapılandırmaları geçersiz kılar.

Yapılandırma örnekleri

Azure Hizmet SDK'ları için genel yeniden deneme yapılandırması

Aşağıdaki örnekte, herhangi bir HTTP veya AMQP protokolü tabanlı Azure SDK istemcisi için yeniden deneme davranışını yapılandırma işlemi gösterilmektedir:

spring.cloud.azure:
  retry:
    mode: exponential
    exponential:
      max-retries: 4
      base-delay: PT0.0801S
      max-delay: PT9S

Key Vault özellik kaynağı için yapılandırmayı yeniden deneyin

Aşağıdaki yapılandırma örneği, Azure Key Vault Gizli Anahtarı istemcisi için yeniden deneme davranışını yapılandırmayı gösterir:

spring.cloud.azure:
  keyvault:
    secret:
      property-source-enabled: true
      property-sources:
        - endpoint: <your-Azure-Key-Vault-endpoint>
          retry:
            mode: exponential
            exponential:
              max-retries: 4
              base-delay: PT0.0801S
              max-delay: PT9S