Panduan pengembang Spring Cloud Azure

  • Artikel

Artikel ini berlaku untuk: ✔️ Versi 4.14.0 ✔️ Versi 5.8.0

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

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.

Tip

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, Bus Layanan, 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 Bus Layanan 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 dari pustaka klien Azure Identity untuk Java.
  • Kontrol akses terperinci di tingkat sumber daya (seperti antrean Bus Layanan) untuk memungkinkan tata kelola dan kepatuhan keamanan yang lebih baik terhadap kebijakan TI.
  • Lebih banyak opsi yang diekspos dengan cara Spring-idiomatic melalui cakupan konfigurasi otomatis klien Azure SDK yang ditingkatkan secara signifikan 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.

Memulai

Menyiapkan dependensi

Tagihan bahan (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>

Catatan

Jika Anda menggunakan Spring Boot 3.x, pastikan untuk mengatur versi ke spring-cloud-azure-dependencies5.8.0. Untuk informasi selengkapnya tentang versi ini spring-cloud-azure-dependencies , 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 spring-cloud-azure-starter-cosmos dependensi dalam proyek Anda.

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

Nama Deskripsi
spring-cloud-azure-starter Starter inti, termasuk dukungan konfigurasi otomatis.
spring-cloud-azure-starter-active-directory 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.
spring-cloud-azure-starter-cosmos 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-secrets 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 Bus Layanan.
spring-cloud-azure-starter-servicebus-jms Starter untuk menggunakan Azure Bus Layanan 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.
spring-cloud-azure-starter-actuator 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 Bus Layanan 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 Bus Layanan 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.

Pembelajaran Spring Cloud Azure

Kami telah menyiapkan daftar lengkap sampel untuk menunjukkan penggunaan. Anda dapat menemukan sampel ini di Sampel Spring Cloud Azure.