Spring Cloud Azure geliştirici kılavuzu

Makale
12/16/2023

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

Spring, VMware tarafından geliştirilen ve Java uygulamaları oluşturmaya yönelik basitleştirilmiş, modüler bir yaklaşım sağlayan bir açık kaynak uygulama çerçevesidir. Spring Cloud Azure, Azure ile sorunsuz Spring tümleştirmesi sağlayan açık kaynak bir projedir.

Desteklenen sürümler hakkında daha fazla bilgi için bkz . Spring Sürümleri Eşlemesi.

Yardım alma

Bu belgeler hakkında sorularınız varsa aşağıdaki GitHub depolarından birinde bir GitHub sorunu oluşturun. Çekme istekleri de kabul edilir.

GitHub depoları	Açıklama
Azure/azure-sdk-for-java	Bu depo kaynak kodu barındırıyor.
MicrosoftDocs/azure-dev-docs	Bu depoda belgeler bulunur.

3.10.x sürümünden bu yana 4.0 sürümündeki yenilikler

Bu belge, 3.10'dan bu yana 4.0'da yapılan değişiklikleri kapsar. Bu önemli sürüm daha iyi güvenlik, daha yalın bağımlılıklar, üretime hazır olma desteği ve daha fazlasını sunar.

Bahşiş

4.0'a geçiş hakkında daha fazla bilgi için bkz . 4.0 için geçiş kılavuzu.

Aşağıdaki listede Spring Cloud Azure 4.0'ın sağladığı bazı değişiklikler özetlemektedir:

Birleştirilmiş proje adı, yapıt kimliği ve özellikleri olan birleşik bir geliştirme deneyimi.
Tek spring-cloud-azure-dependencies bir ürün reçetesi kullanılarak basitleştirilmiş bağımlılık yönetimi.
Spring Initializr'daki Azure desteği Kafka, Event Hubs, Redis için Azure Cache ve Azure Uygulaması Yapılandırması'nı kapsayacak şekilde genişletildi.
Fazla katmanları ve dolanıklığı ortadan kaldırmak için spring modülü bağımlılıklarını yeniden oluşturun.
Azure Uygulaması Yapılandırması, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Depolama Blob ve Depolama Kuyruğu için Yönetilen Kimlik desteği.
Service Bus ve Event Hubs ile SAS belirteci ve belirteç kimlik bilgisi kimlik doğrulaması gibi Spring kitaplıklarımızdan temel alınan Azure SDK'sında kimlik doğrulama yöntemleri için devam eden destek.
Kimlik bilgisi zinciri artık varsayılan olarak etkinleştirilerek uygulamaların uygulama özelliklerinden, ortam değişkenlerinden, yönetilen kimlikten, IDE'lerden vb. kimlik bilgilerini almasını sağlar. Daha fazla bilgi için Java için Azure Identity istemci kitaplığının DefaultAzureCredential bölümüne bakın.
Daha iyi güvenlik idaresi sağlamak ve BT ilkelerine bağlı kalmak için kaynak düzeyinde (Service Bus kuyruğu gibi) ayrıntılı erişim denetimi.
Hem zaman uyumlu hem de zaman uyumsuz senaryolar için Azure SDK istemcilerinin önemli ölçüde geliştirilmiş otomatik yapılandırma kapsamı aracılığıyla Spring-idiomatic ile sunulan diğer seçenekler.
Azure Uygulaması Yapılandırması, Event Hubs, Azure Cosmos DB, Key Vault, Depolama Blob, Depolama Kuyruğu ve Depolama Dosyası için sistem durumu göstergeleri eklendi.
Tüm HTTP tabanlı Azure SDK'ları için Spring Cloud Sleuth desteği.

4.0 için geçiş kılavuzu

4.0'a geçiş hakkında daha fazla bilgi için bkz . 4.0 için geçiş kılavuzu.

Başlarken

Bağımlılıkları ayarlama

Ürün reçetesi (BOM)

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>4.14.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Dekont

Spring Boot 3.x kullanıyorsanız, sürümünü olarak 5.8.0ayarladığınızdan spring-cloud-azure-dependencies emin olun. Sürüm hakkında spring-cloud-azure-dependencies daha fazla bilgi için bkz . Spring Cloud Azure'ın Hangi Sürümünü Kullanmalıyım.

Başlangıç bağımlılıkları

Spring Cloud Azure Starters, uygulamanıza dahil etmek için kullanışlı bağımlılık tanımlayıcıları kümesidir. Her başlatıcı, ilgili Spring Cloud Azure modülünü kullanmaya başlamak için gereken tüm bağımlılıkları ve geçişli bağımlılıkları içerir. Bu başlatıcılar, Azure hizmetleriyle Spring Boot uygulama geliştirmenizi artırır.

Örneğin, veri kalıcılığı için Spring ve Azure Cosmos DB kullanmaya başlamak istiyorsanız, projenize bağımlılığı ekleyin spring-cloud-azure-starter-cosmos .

Aşağıdaki tabloda Spring Cloud Azure tarafından grup altında com.azure.spring sağlanan uygulama başlangıçları listelenir:

Adı	Açıklama
spring-cloud-azure-starter	Otomatik yapılandırma desteği dahil olmak üzere temel başlatıcı.
spring-cloud-azure-starter-active-directory	Microsoft Entra ID'yi Spring Security ile kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-active-directory-b2c	Spring Security ile Azure Active Directory B2C'yi kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-appconfiguration	Azure Uygulaması Yapılandırması'nı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-cosmos	Azure Cosmos DB'yi kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-eventhubs	Azure Event Hubs'ı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-keyvault	Azure Key Vault'un kullanımı için Başlangıç.
spring-cloud-azure-starter-keyvault-secrets	Azure Key Vault Gizli Dizilerini kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-keyvault-certificates	Azure Key Vault Sertifikalarını kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-servicebus	Azure Service Bus'ın kullanımına yönelik başlangıç.
spring-cloud-azure-starter-servicebus-jms	Azure Service Bus ve JMS'yi kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage	Azure Depolama kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-blob	Azure Depolama Blob'unu kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-file-share	Azure Depolama Dosya Paylaşımı'nı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-queue	Azure Depolama Kuyruğu'nı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-aktüatör	Spring Boot'un üretime hazır özellikler sağlayan Aktüatör'lerini kullanmaya yönelik başlangıç.

Aşağıdaki tabloda Spring Data desteği için başlangıç bilgileri listelemektedir:

Adı	Açıklama
spring-cloud-azure-starter-data-cosmos	Azure Cosmos DB için Spring Data'nın kullanımına yönelik başlangıç.

Aşağıdaki tabloda Spring Integration desteğine yönelik başlangıçlar listelemektedir:

Adı	Açıklama
spring-cloud-azure-starter-integration-eventhubs	Azure Event Hubs ve Spring Integration'ı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-integration-servicebus	Azure Service Bus ve Spring Integration'ı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-integration-storage-queue	Azure Depolama Kuyruğu ve Spring Tümleştirmesi'ni kullanmaya yönelik başlangıç.

Aşağıdaki tabloda Spring Cloud Stream desteği için yeni başlayanlar listelemektedir:

Adı	Açıklama
spring-cloud-azure-starter-stream-eventhubs	Azure Event Hubs ve Spring Cloud Stream Binder'ı kullanmaya yönelik başlangıçlar.
spring-cloud-azure-starter-stream-servicebus	Azure Service Bus ve Spring Cloud Stream Binder'ı kullanmaya yönelik başlangıç.

Aşağıdaki tabloda MySQL desteği için başlatıcılar listelemektedir:

Adı	Açıklama
spring-cloud-azure-starter-jdbc-mysql	Microsoft Entra kimlik doğrulaması aracılığıyla Azure MySQL'leri ve JDBC'yi kullanmaya yönelik başlangıçlar.

Aşağıdaki tabloda PostgreSQL desteği için yeni başlayanlar listelemektedir:

Adı	Açıklama
spring-cloud-azure-starter-jdbc-postgresql	Microsoft Entra kimlik doğrulaması aracılığıyla Azure PostgreSQL ve JDBC'yi kullanmaya yönelik başlangıçlar.

Spring Cloud Azure'i öğrenme

Kullanımı göstermek için örneklerin tam listesini hazırladık. Bu örnekleri Spring Cloud Azure Örnekleri'nde bulabilirsiniz.

Aracılığıyla paylaş