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.
MicrosoftDocs/azure-dev-docs	Repositori ini menyimpan dokumentasi.

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.
• Dukungan Azure yang diperluas di Spring Initializr untuk mencakup Kafka, 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, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob, dan Storage Queue.
• Dukungan berkelanjutan untuk metode autentikasi di Azure SDK yang mendasarinya dari pustaka Spring kami, seperti token SAS dan autentikasi kredensial token dengan Azure Service Bus dan 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 dari pustaka klien Azure Identity untuk Java.
• Kontrol akses terperinci di tingkat sumber daya (seperti antrean Bus Layanan) untuk memungkinkan tata kelola keamanan dan kepatuhan yang lebih baik terhadap kebijakan TI.
• Lebih banyak opsi yang diekspos dengan cara Spring-idiomatic melalui cakupan konfigurasi otomatis klien Azure SDK yang ditingkatkan untuk skenario sinkron dan asinkron.
• Menambahkan indikator kesehatan untuk Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue, dan Storage File.
• Dukungan Spring Cloud Sleuth untuk semua Azure SDK berbasis HTTP.

Panduan migrasi untuk 4.0

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

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>5.22.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 "3.2.O"
  }
  
  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.0"
  }
  
  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 2.x, pastikan untuk mengatur versi spring-cloud-azure-dependencies ke 4.20.0. Bill of Material (BOM) ini harus dikonfigurasi di bagian <dependencyManagement> 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 mana yang 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 Spring Cloud Azure 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	Permulaan untuk menggunakan ID Microsoft Entra 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.
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-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-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 Azure Storage Queue.
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 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	Permulaan 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	Permulaan 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	Permulaan untuk menggunakan Azure PostgreSQL dan JDBC melalui autentikasi Microsoft Entra.

Belajar Spring Cloud Azure

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