Spring Cloud Azure geliştirici kılavuzu

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 versions mapping.

Yardım alın

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.0iç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 bir spring-cloud-azure-dependencies ürün reçetesi kullanılarak basitleştirilmiş bağımlılık yönetimi.
• Spring Initializr üzerinde Kafka, Event Hubs, Redis için Azure Cache ve Azure Uygulama Yapılandırması'nı kapsayacak şekilde Genişletilmiş Azure desteği.
• Fazla katmanları ve dolanıklığı ortadan kaldırmak için spring modülü bağımlılıklarını yeniden oluşturun.
• Azure Uygulama Yapılandırması, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Depolama Blobu 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 Javaiç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 geliştirilmiş otomatik yapılandırma kapsamı aracılığıyla Spring-idiomatic ile sunulan diğer seçenekler.
• Azure Uygulama Yapılandırması, Event Hubs, Azure Cosmos DB, Key Vault, Depolama Blobu, 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.0için Geçiş kılavuzu.

Başlarken

Bağımlılıkları ayarlama

Ürün reçetesi (BOM)

Maven kullanıyorsanız, aşağıdaki örnekte gösterildiği gibi ürün reçetesini bölümünde dependencyManagement dosyanıza ekleyin. Ürün reçetesini kullandığınızda, sürüm oluşturma ürün reçetesine temsilci olarak atandığından Maven bağımlılıklarından herhangi birinin sürümlerini belirtmeniz gerekmez.

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

Gradle ile spring-cloud-azure-dependencies BOM'u aşağıdaki yollarla içeri aktarabilirsiniz:

• Aşağıdaki örnekte gösterildiği gibi bağımlılıkları ekleyerek Gradle'ın yerel ÜRÜN REÇETESI desteğini kullanın:

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "3.2.O"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• aşağıdaki örnekte gösterildiği gibi io.spring.dependency-management eklentisini kullanın ve ürün reçetesini dependencyManagementiçeri aktarın:

  plugins {
      id("io.spring.dependency-management") version "1.1.0"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Daha fazla bilgi için bkz. Spring Boot Gradle Eklentisi Başvuru Kılavuzu.

Not

Spring Boot 3.0.x-3.4.x kullanıyorsanız sürümü olarak 5.23.0ayarladığınızdan spring-cloud-azure-dependencies emin olun.

Spring Boot 2.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 4.20.0olarak ayarladığınızdan emin olun.

Bu Ürün Reçetesi (BOM), <dependencyManagement> dosyanızın bölümünde yapılandırılmalıdır. Bu, tüm Spring Cloud Azure bağımlılıklarının aynı sürümü kullanmasını sağlar.

Bu ürün reçetesi için kullanılan sürüm hakkında 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 spring-cloud-azure-starter-cosmos bağımlılığını ekleyin.

Aşağıdaki tabloda Spring Cloud Azure tarafından com.azure.spring grubu altında 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ıç.
bahar-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 Uygulama 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'yı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-blob	Azure Depolama Blobu'na 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'na 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österen örneklerin tam listesi için bkz. Spring Cloud Azure Örnekleri.