Panduan pengembang Spring Cloud Azure

Spring adalah kerangka kerja aplikasi sumber terbuka yang dikembangkan oleh VMware yang menyediakan pendekatan modular yang disederhanakan untuk membuat aplikasi Java. Spring Cloud Azure adalah proyek sumber terbuka yang menyediakan integrasi Spring tanpa hambatan dengan Azure.

Untuk informasi selengkapnya tentang versi yang didukung, lihat Pemetaan Versi Spring.

Dapatkan bantuan

Jika Anda memiliki pertanyaan tentang dokumentasi ini, buat masalah GitHub di salah satu repositori GitHub berikut. Permintaan pull juga dipersilakan.

repositori GitHub	Deskripsi
Azure/azure-sdk-for-java	Repositori ini menyimpan kode sumber.
Azure-Samples/azure-spring-boot-samples	Repositori ini menyimpan sampel terkait.
MicrosoftDocs/azure-dev-docs	Repositori ini menyimpan dokumentasi.

Persiapan

Menyiapkan dependensi

Tagihan bahan (BOM)

Jika Anda menggunakan Maven, tambahkan BOM ke file pom.xml Anda di bagian dependencyManagement, seperti yang ditunjukkan dalam contoh berikut. Saat menggunakan BOM, Anda tidak perlu menentukan versi untuk salah satu dependensi Maven karena penerapan versi didelegasikan ke BOM.

<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>

Dengan Gradle, Anda dapat mengimpor spring-cloud-azure-dependencies BOM dengan cara berikut:

• Gunakan dukungan BOM asli Gradle dengan menambahkan dependensi seperti yang ditunjukkan dalam contoh berikut:

  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}"))
  }
  

• Gunakan plugin io.spring.dependency-management dan impor BOM di dependencyManagement, seperti yang ditunjukkan dalam contoh berikut:

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

Untuk informasi selengkapnya, lihat Panduan Referensi Plugin Spring Boot Gradle.

Nota

Jika Anda menggunakan Spring Boot 4.0.x, pastikan untuk mengatur versi ke spring-cloud-azure-dependencies7.1.0.

Jika Anda menggunakan Spring Boot 3.5.x, pastikan untuk mengatur versi ke spring-cloud-azure-dependencies6.1.0.

Jika Anda menggunakan Spring Boot 3.1.x-3.5.x, pastikan untuk mengatur versi ke spring-cloud-azure-dependencies5.25.0.

Jika Anda menggunakan Spring Boot 2.x, pastikan untuk mengatur versi spring-cloud-azure-dependencies ke 4.20.0.

Bill of Material (BOM) ini harus dikonfigurasi di bagian <dependencyManagement> dari file pom.xml Anda. Ini memastikan bahwa semua dependensi Spring Cloud Azure menggunakan versi yang sama.

Untuk informasi selengkapnya tentang versi yang digunakan untuk BOM ini, lihat Versi Spring Cloud Azure Harus Saya Gunakan.

Dependensi pemula

Spring Cloud Azure Starters adalah sekumpulan deskriptor dependensi yang nyaman untuk disertakan dalam aplikasi Anda. Setiap pemula berisi semua dependensi dan dependensi transitif yang diperlukan untuk mulai menggunakan modul Azure Spring Cloud yang sesuai. Pemula ini meningkatkan pengembangan aplikasi Spring Boot Anda dengan layanan Azure.

Misalnya, jika Anda ingin mulai menggunakan Spring dan Azure Cosmos DB untuk persistensi data, sertakan dependensi spring-cloud-azure-starter-cosmos dalam proyek Anda.

Tabel berikut mencantumkan permulaan aplikasi yang disediakan oleh Spring Cloud Azure di bawah grup com.azure.spring:

Nama	Deskripsi
Musim Semi-awan-biru-starter	Starter inti, termasuk dukungan konfigurasi otomatis.
Direktori-aktif Spring-cloud-Azure-starter	Starter untuk menggunakan Microsoft Entra ID dengan Spring Security.
Spring-cloud-Azure-starter-active-directory-b2c	Starter untuk menggunakan Azure Active Directory B2C dengan Spring Security.
Spring-cloud-Azure-starter-appconfiguration	Starter untuk menggunakan Azure App Configuration.
spring-cloud-azure-starter-appconfiguration-config	Starter untuk menggunakan Azure App Configuration Config.
Musim Semi-Awan-Biru-Pemula-Kosmos	Starter untuk menggunakan Azure Cosmos DB.
Spring-Cloud-Azure-starter-eventhubs	Starter untuk menggunakan Azure Event Hubs.
spring-cloud-azure-starter-eventgrid	Starter untuk menggunakan Azure Event Grid.
spring-cloud-azure-starter-keyvault	Starter untuk menggunakan Azure Key Vault.
Spring-cloud-azure-starter-keyvault-rahasia	Starter untuk menggunakan Rahasia Azure Key Vault.
spring-cloud-azure-starter-keyvault-jca	Starter untuk menggunakan Azure Key Vault JCA.
Spring-cloud-azure-starter-keyvault-certificates	Starter untuk menggunakan Sertifikat Azure Key Vault.
spring-cloud-azure-starter-servicebus	Starter untuk menggunakan Azure Service Bus.
Spring-cloud-Azure-starter-servicebus-jms	Starter untuk menggunakan Azure Service Bus dan JMS.
Spring-cloud-azure-starter-storage	Starter untuk menggunakan Azure Storage.
spring-cloud-azure-starter-storage-blob	Starter untuk menggunakan Azure Storage Blob.
Spring-cloud-azure-starter-storage-file-share	Starter untuk menggunakan Azure Storage File Share.
spring-cloud-azure-starter-storage-queue	Starter untuk menggunakan antrean Azure Storage.
aktuator pegas-awan-biru-starter	Starter untuk menggunakan Spring Boot's Actuator, yang menyediakan fitur siap produksi.

Tabel berikut ini mencantumkan starter untuk dukungan Spring Data:

Nama	Deskripsi
Spring-cloud-azure-starter-data-cosmos	Starter untuk menggunakan Spring Data untuk Azure Cosmos DB.

Tabel berikut ini mencantumkan starter untuk dukungan Spring Data Redis:

Nama	Deskripsi
spring-cloud-azure-starter-data-redis-lettuce	Starter untuk menggunakan Spring Data dan Azure Cache for Redis dengan Lettuce.

Tabel berikut ini mencantumkan starter untuk dukungan Integrasi Spring:

Nama	Deskripsi
Spring-cloud-azure-starter-integration-eventhubs	Starter untuk menggunakan Azure Event Hubs dan Spring Integration.
spring-cloud-azure-starter-integration-servicebus	Starter untuk menggunakan Azure Service Bus dan Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	Starter untuk menggunakan antrean Azure Storage dan Integrasi Spring.

Tabel berikut ini mencantumkan starter untuk dukungan Spring Cloud Stream:

Nama	Deskripsi
Spring-Cloud-Azure-starter-stream-eventhubs	Starter untuk menggunakan Azure Event Hubs dan Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus	Starter untuk menggunakan Azure Service Bus dan Spring Cloud Stream Binder.

Tabel berikut ini mencantumkan starter untuk dukungan MySQL:

Nama	Deskripsi
spring-cloud-azure-starter-jdbc-mysql	Starter untuk menggunakan Azure MySQLs dan JDBC melalui autentikasi Microsoft Entra.

Tabel berikut ini mencantumkan starter untuk dukungan PostgreSQL:

Nama	Deskripsi
spring-cloud-azure-starter-jdbc-postgresql	Starter untuk menggunakan Azure PostgreSQL dan JDBC melalui autentikasi Microsoft Entra.

Mempelajari Azure Spring Cloud

Untuk daftar lengkap sampel yang memperlihatkan penggunaan, lihat Sampel Azure Spring Cloud.

Apa yang baru di 4.0 sejak 3.10.x

Dokumentasi ini mencakup perubahan yang dilakukan dalam 4.0 sejak 3.10. Rilis utama ini menghadirkan keamanan yang lebih baik, dependensi yang lebih ramping, dukungan untuk kesiapan produksi, dan banyak lagi.

Ujung

Untuk informasi selengkapnya tentang migrasi ke 4.0, lihat panduan Migrasi untuk 4.0.

Daftar berikut ini merangkum beberapa perubahan yang disediakan Spring Cloud Azure 4.0:

• Pengalaman pengembangan terpadu, dengan nama proyek terpadu, ID artefak, dan properti.
• Manajemen dependensi yang disederhanakan menggunakan satu spring-cloud-azure-dependencies BOM.
• Memperluas Azure support pada Spring Initializr untuk mencakup Kafka, Azure Event Hubs, Azure Cache for Redis, dan Azure App Configuration.
• Rearchitected Spring module dependensi untuk menghapus lapisan berlebih dan entanglement.
• Dukungan Identitas Terkelola untuk Azure App Configuration, Azure Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Blob Penyimpanan, dan Antrean Penyimpanan.
• Dukungan berkelanjutan untuk metode autentikasi di Azure SDK yang mendasari dari pustaka Spring kami, seperti token SAS dan autentikasi kredensial token dengan Service Bus dan Azure Event Hubs.
• Rantai kredensial sekarang diaktifkan secara default, memungkinkan aplikasi untuk mendapatkan kredensial dari properti aplikasi, variabel lingkungan, identitas terkelola, IDEs, dan sebagainya. Untuk informasi selengkapnya, lihat bagian DefaultAzureCredential pustaka klien Azure Identity untuk Java.
• Kontrol akses terperinci di tingkat sumber daya (seperti antrean Service Bus) untuk memungkinkan tata kelola dan kepatuhan keamanan yang lebih baik terhadap kebijakan TI.
• Lebih banyak opsi yang diekspos dengan cara Spring-idiomatic melalui peningkatan cakupan konfigurasi otomatis klien Azure SDK untuk skenario sinkron dan asinkron.
• Menambahkan indikator kesehatan untuk Azure App Configuration, Azure Event Hubs, Azure Cosmos DB, Key Vault, Blob Penyimpanan, Antrean Penyimpanan, dan File Penyimpanan.
• Dukungan Spring Cloud Sleuth untuk semua Azure SDKs berbasis HTTP.