Konfigurasi Spring Cloud Azure

Artikel ini menjelaskan semua properti konfigurasi umum Spring Cloud Azure.

Konfigurasi untuk setiap Azure Service SDK

Sebagian besar SDK Layanan Azure dapat dibagi menjadi dua kategori berdasarkan jenis transportasi: berbasis HTTP atau berbasis AMQP. Ada properti yang umum untuk semua SDK, seperti prinsip autentikasi dan pengaturan lingkungan Azure, atau umum untuk klien berbasis HTTP, seperti tingkat pengelogan untuk mencatat permintaan dan respons HTTP. Dimulai dengan Spring Cloud Azure 4.0, kami menambahkan lima kategori umum properti konfigurasi yang dapat Anda tentukan untuk setiap layanan Azure.

Tabel berikut ini mencantumkan properti umum untuk beberapa layanan:

Harta benda	Deskripsi
Spring.cloud.azure.azure-service.client	Mengonfigurasi klien transportasi di bawah satu SDK layanan Azure.
spring.cloud.azure.azure-service.credential	Mengonfigurasi autentikasi dengan ID Microsoft Entra untuk satu SDK layanan Azure.
spring.cloud.azure.azure-service.profile	Mengonfigurasi lingkungan cloud Azure untuk satu SDK layanan Azure.
spring.cloud.azure.azure-service.proxy	Mengonfigurasi opsi proksi untuk satu SDK layanan Azure.
spring.cloud.azure.azure-service.retry	Mengonfigurasi opsi coba lagi yang berlaku untuk satu SDK layanan Azure. Opsi coba lagi telah mendukung bagian dari SDK, tidak ada spring.cloud.azure.cosmos.retry.

Awalan properti konfigurasi telah disatukan ke namespace spring.cloud.azure sejak Spring Cloud Azure 4.0 untuk membuat properti konfigurasi lebih konsisten dan lebih intuitif. Tabel berikut ini menyediakan tinjauan cepat awalan untuk layanan Azure yang didukung:

Layanan Azure	Awalan properti konfigurasi	Tautan properti konfigurasi
Konfigurasi Aplikasi Azure	Spring.cloud.azure.appconfiguration	properti konfigurasi App Configuration
Azure Cosmos DB (layanan basis data global dari Microsoft)	musim semi.awan.azure.kosmos	properti konfigurasi Azure Cosmos DB
Azure Event Hubs	spring.cloud.azure.eventhubs	properti konfigurasi Azure Event Hubs
Sertifikat Azure Key Vault	Spring.cloud.azure.keyvault.certificate	properti konfigurasi Sertifikat Key Vault
Rahasia Azure Key Vault	musim semi.cloud.azure.keyvault.rahasia	properti konfigurasi Rahasia Key Vault
Azure Service Bus (Layanan Bus oleh Azure)	musim semi.cloud.azure.servicebus	properti konfigurasi Bus Layanan
Azure Storage Blob	musim semi.cloud.azure.storage.blob	properti konfigurasi Storage Blob
Berbagi File Azure Storage	musim semi.cloud.azure.storage.fileshare	properti konfigurasi Berbagi File Penyimpanan
Antrean Azure Storage	spring.cloud.azure.storage.queue	properti konfigurasi Antrean Penyimpanan

Konfigurasi global untuk Azure Service SDK

Ada beberapa properti yang dapat Anda bagikan di antara layanan Azure yang berbeda, misalnya untuk menggunakan perwakilan layanan yang sama untuk mengakses Azure Cosmos DB dan Azure Event Hubs. Spring Cloud Azure 4.0 memungkinkan Anda menentukan properti yang berlaku untuk semua Azure SDK di namespace spring.cloud.azure.

Tabel berikut ini mencantumkan properti global:

Harta benda	Deskripsi
Spring.cloud.azure.client	Mengonfigurasi klien transportasi; berlaku untuk semua Azure SDK secara default.
musim semi.cloud.azure.kredensial	Mengonfigurasi autentikasi dengan ID Microsoft Entra untuk semua Azure SDK secara default.
spring.cloud.azure.profile	Mengonfigurasi lingkungan cloud Azure untuk semua Azure SDK secara default.
musim semi.cloud.azure.proxy	Mengonfigurasi opsi proksi yang berlaku untuk semua klien Azure SDK secara default.
spring.cloud.azure.retry	Mengonfigurasi opsi coba lagi yang berlaku untuk semua klien Azure SDK secara default.

Nota

Properti yang dikonfigurasi di bawah setiap layanan Azure akan mengambil alih konfigurasi global.

Contoh konfigurasi

Konfigurasi coba lagi global untuk Azure Service SDK

Contoh berikut menunjukkan kepada Anda cara mengonfigurasi perilaku coba lagi untuk klien Azure SDK berbasis protokol HTTP atau AMQP apa pun:

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

Coba lagi konfigurasi untuk sumber properti Key Vault

Contoh konfigurasi berikut menunjukkan kepada Anda cara mengonfigurasi perilaku coba lagi untuk klien Rahasia Azure Key Vault:

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