Guida per sviluppatori di Spring Cloud Azure

Articolo
10/23/2023

Questo articolo si applica a: ✔️ Versione 4.14.0 ✔️ versione 5.8.0

Spring è un framework di applicazioni open source, sviluppato da VMware, che fornisce un approccio modulare semplificato alla creazione di applicazioni Java. Spring Cloud Azure è un progetto open source che offre un'integrazione spring senza problemi con Azure.

Per altre informazioni sulle versioni supportate, vedere Mapping delle versioni spring.

Come ottenere assistenza

In caso di domande su questa documentazione, creare un problema di GitHub in uno dei repository GitHub seguenti. Sono benvenute anche le richieste pull.

Repository GitHub	Descrizione
Azure/azure-sdk-for-java	Questo repository contiene il codice sorgente.
MicrosoftDocs/azure-dev-docs	Questo repository contiene la documentazione.

Novità della versione 4.0 dalla versione 3.10.x

Questa documentazione illustra le modifiche apportate nella versione 4.0 dalla versione 3.10. Questa versione principale offre maggiore sicurezza, dipendenze più snella, supporto per l'idoneità alla produzione e altro ancora.

Suggerimento

Per altre informazioni sulla migrazione alla versione 4.0, vedere Guida alla migrazione per la versione 4.0.

L'elenco seguente riepiloga alcune delle modifiche fornite da Spring Cloud Azure 4.0:

Esperienza di sviluppo unificata, con nome di progetto unificato, ID artefatto e proprietà.
Gestione semplificata delle dipendenze tramite una singola spring-cloud-azure-dependencies distinta base.
Espanso supporto tecnico di Azure in Spring Initializr per coprire Kafka, Hub eventi, cache di Azure per Redis e configurazione di app Azure.
Dipendenze del modulo Spring riprogettate per rimuovere i livelli in eccesso e l'entanglement.
Supporto delle identità gestite per la configurazione di app Azure, Hub eventi, bus di servizio, Azure Cosmos DB, Key Vault, BLOB Archiviazione e coda di Archiviazione.
Supporto continuo per i metodi di autenticazione nell'SDK di Azure sottostante dalle librerie Spring, ad esempio token di firma di accesso condiviso e autenticazione delle credenziali dei token con bus di servizio e Hub eventi.
La catena di credenziali è ora abilitata per impostazione predefinita, consentendo alle applicazioni di ottenere le credenziali dalle proprietà dell'applicazione, dalle variabili di ambiente, dall'identità gestita, dagli IDE e così via. Per altre informazioni, vedere la sezione DefaultAzureCredential della libreria client di Identità di Azure per Java.
Controllo di accesso granulare a livello di risorsa ,ad esempio bus di servizio coda, per consentire una migliore governance della sicurezza e conformità ai criteri IT.
Altre opzioni esposte in modo idiotico Spring tramite una migliore copertura della configurazione automatica dei client Azure SDK per scenari sincroni e asincroni.
Sono stati aggiunti indicatori di integrità per app Azure Configurazione, Hub eventi, Azure Cosmos DB, Key Vault, BLOB Archiviazione, coda Archiviazione e file Archiviazione.
Supporto di Spring Cloud Sleuth per tutti gli SDK di Azure basati su HTTP.

Guida alla migrazione per la versione 4.0

Per altre informazioni sulla migrazione alla versione 4.0, vedere Guida alla migrazione per la versione 4.0.

Attività iniziali

Configurazione delle dipendenze

Distinta base (DBA)

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

Nota

Se si usa Spring Boot 3.x, assicurarsi di impostare la spring-cloud-azure-dependencies versione su 5.8.0. Per altre informazioni sulla spring-cloud-azure-dependencies versione, vedere Quale versione di Spring Cloud Azure è consigliabile usare.

Dipendenze di avvio

Spring Cloud Azure Starters è un set di utili descrittori di dipendenza da includere nell'applicazione. Ogni avvio contiene tutte le dipendenze e le dipendenze transitive necessarie per iniziare a usare il modulo Spring Cloud Azure corrispondente. Questi strumenti di avvio migliorano lo sviluppo di applicazioni Spring Boot con i servizi di Azure.

Ad esempio, se si vuole iniziare a usare Spring e Azure Cosmos DB per la persistenza dei dati, includere la spring-cloud-azure-starter-cosmos dipendenza nel progetto.

La tabella seguente elenca gli starter dell'applicazione forniti da Spring Cloud Azure nel com.azure.spring gruppo:

Nome	Descrizione
spring-cloud-azure-starter	Lo starter principale, incluso il supporto della configurazione automatica.
spring-cloud-azure-starter-active-directory	Lo starter per l'uso di Microsoft Entra ID con Spring Security.
spring-cloud-azure-starter-active-directory-b2c	Lo strumento di avvio per l'uso di Azure Active Directory B2C con Spring Security.
spring-cloud-azure-starter-appconfiguration	Avvio per l'uso di app Azure Configurazione.
spring-cloud-azure-starter-cosmos	Lo starter per l'uso di Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	Lo starter per l'uso di Hub eventi di Azure.
spring-cloud-azure-starter-keyvault	Starter per l'uso di Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets	Lo starter per l'uso dei segreti di Azure Key Vault.
spring-cloud-azure-starter-keyvault-certificates	Lo starter per l'uso dei certificati di Azure Key Vault.
spring-cloud-azure-starter-servicebus	Avvio per l'uso di bus di servizio di Azure.
spring-cloud-azure-starter-servicebus-jms	Lo starter per l'uso di bus di servizio di Azure e JMS.
spring-cloud-azure-starter-storage	Lo starter per l'uso di Archiviazione di Azure.
spring-cloud-azure-starter-storage-blob	Lo strumento iniziale per l'uso di Archiviazione di Azure BLOB.
spring-cloud-azure-starter-storage-file-share	Avvio per l'uso di Archiviazione di Azure condivisione file.
spring-cloud-azure-starter-storage-queue	Avvio per l'uso di Archiviazione di Azure Coda.
spring-cloud-azure-starter-accelerator	Lo starter per l'uso dell'attuatore di Spring Boot, che fornisce funzionalità pronte per la produzione.

La tabella seguente elenca gli starter per il supporto di Spring Data:

Nome	Descrizione
spring-cloud-azure-starter-data-cosmos	Avvio per l'uso di Spring Data per Azure Cosmos DB.

La tabella seguente elenca gli starter per il supporto di Spring Integration:

Nome	Descrizione
spring-cloud-azure-starter-integration-eventhubs	Lo strumento iniziale per l'uso di Hub eventi di Azure e Spring Integration.
spring-cloud-azure-starter-integration-servicebus	Lo strumento di avvio per l'uso di bus di servizio di Azure e Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	Avvio per l'uso di Archiviazione di Azure Queue e Spring Integration.

La tabella seguente elenca gli starter per il supporto di Spring Cloud Stream:

Nome	Descrizione
spring-cloud-azure-starter-stream-eventhubs	Gli starter per l'uso di Hub eventi di Azure e Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus	Lo strumento di avvio per l'uso di bus di servizio di Azure e Spring Cloud Stream Binder.

La tabella seguente elenca gli starter per il supporto di MySQL:

Nome	Descrizione
spring-cloud-azure-starter-jdbc-mysql	Gli starter per l'uso di Azure MySQLs e JDBC tramite l'autenticazione di Microsoft Entra.

La tabella seguente elenca gli starter per il supporto di PostgreSQL:

Nome	Descrizione
spring-cloud-azure-starter-jdbc-postgresql	Gli starter per l'uso di Azure PostgreSQL e JDBC tramite l'autenticazione di Microsoft Entra.

Learning Spring Cloud Azure

È stato preparato un elenco completo di esempi per visualizzare l'utilizzo. Questi esempi sono disponibili in Spring Cloud Azure Samples (Esempi di Azure Spring Cloud).