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 kaynaklı bir projedir.

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

Yardım alın

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

GitHub depoları	Açıklama
Azure/azure-sdk-for-java	Bu depo kaynak kodu barındırıyor.
Azure-Samples/azure-spring-boot-samples	Bu depo, ilgili örnekleri barındırır.
MicrosoftDocs/azure-dev-docs	Bu depoda belgeler bulunur.

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>7.1.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 "4.0.1"
  }
  
  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.7"
  }
  
  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 4.0.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 7.1.0 olarak ayarladığınızdan emin olun.

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

Spring Boot 3.1.x-3.5.x kullanıyorsanız sürümü olarak spring-cloud-azure-dependenciesayarladığınızdan 5.25.0 emin olun.

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

Bu Parça Listesi (BOM), <dependencyManagement> bölümünde pom.xml dosyanızda 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. Bağlı Bulut Azure Kullanmam Gereken Sürü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ı, karşılık gelen 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, com.azure.spring grubu altında Spring Cloud Azure tarafından 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	Spring Security ile Microsoft Entra ID 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 App Configuration kullanmak için başlangıç.
spring-cloud-azure-starter-appconfiguration-config	Azure App Configuration Yapılandırması'nı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-cosmos	Azure Cosmos DB kullanmak için başlangıç.
spring-cloud-azure-starter-eventhubs	Azure Event Hubs kullanmak için başlangıç.
spring-cloud-azure-starter-eventgrid	Azure Event Grid kullanmak için başlangıç.
spring-cloud-azure-starter-keyvault	Azure Key Vault kullanmak için başlangıç.
spring-cloud-azure-starter-keyvault-secrets	Azure Key Vault Gizli Dizileri kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-keyvault-jca	Azure Key Vault JCA kullanmak için 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 kullanmak için 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 Storage kullanmak için başlangıç.
spring-cloud-azure-starter-storage-blob	Azure Storage Blobu kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-file-share	Azure Storage Dosya Paylaşımı'nı kullanmaya yönelik başlangıç.
spring-cloud-azure-starter-storage-queue	Azure Storage 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 Data Redis desteği için başlangıç bilgileri listelemektedir:

Ad	Açıklama
spring-cloud-azure-starter-data-redis-lettuce	Spring Data ve Azure Cache for Redis'ı Marul ile kullanmaya 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 Storage 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ıç.
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ıç.

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ıç.

Spring Cloud Azure öğrenme

Kullanımı gösteren örneklerin tam listesi için bkz. Spring Cloud Azure Samples.

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, Azure Cache for Redis ve Azure App Configuration kapsayacak şekilde genişletilmiş Azure support.
• Fazla katmanları ve dolanıklığı ortadan kaldırmak için spring modülü bağımlılıklarını yeniden oluşturun.
• Azure App Configuration, 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 Azure SDK 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 geliştirilmiş otomatik yapılandırma kapsamı aracılığıyla Spring-idiomatic ile sunulan diğer seçenekler.
• Azure App Configuration, 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 SDKs için Spring Cloud Sleuth desteği.