Spring Cloud Azure yapılandırması

Makale
12/13/2023

Bu makale şunlar için geçerlidir: ✔️ Sürüm 4.14.0 ✔️ Sürüm 5.8.0

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'da, 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:

Özellik	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 özelliklerinin ön ekleri, yapılandırma özelliklerini daha tutarlı ve daha sezgisel hale getirmek için Spring Cloud Azure 4.0'dan bu yana ad alanıyla birleştirildi spring.cloud.azure . 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	yapılandırma özelliklerini Uygulama Yapılandırması
Azure Cosmos DB	spring.cloud.azure.cosmos	Azure Cosmos DB yapılandırma özellikleri
Azure Event Hubs	spring.cloud.azure.eventhubs	Event Hubs yapılandırma özellikleri
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 özellikleri
Azure Service Bus	spring.cloud.azure.servicebus	Service Bus yapılandırma özellikleri
Azure Depolama Blobu	spring.cloud.azure.storage.blob	blob yapılandırma özelliklerini Depolama
Azure Depolama Dosya Paylaşımı	spring.cloud.azure.storage.fileshare	Dosya Paylaşımı yapılandırma özelliklerini Depolama
Azure Depolama Kuyruğu	spring.cloud.azure.storage.queue	Kuyruk yapılandırma özelliklerini Depolama

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ında spring.cloud.azuretüm Azure SDK'larına uygulanan özellikleri tanımlamanızı sağlar.

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

Özellik	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	Varsayılan olarak tüm Azure SDK istemcileri için geçerli olan yeniden deneme seçeneklerini yapılandırılır.

Dekont

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

Aracılığıyla paylaş