Azure-Entwicklerhandbuch für Spring Cloud

Dieser Artikel bezieht sich auf: ✔️ Version 4.14.0 ✔️ Version 5.8.0

Spring ist ein von VMware entwickeltes Open-Source-Anwendungsframework, das ein vereinfachtes, modulares Verfahren für die Erstellung von Java-Anwendungen bereitstellt. Spring Cloud Azure ist ein Open-Source-Projekt, das eine nahtlose Spring-Integration in Azure bietet.

Weitere Informationen zu unterstützten Versionen finden Sie unter Spring Versions Mapping.

Hilfe erhalten

Wenn Sie Fragen zu dieser Dokumentation haben, erstellen Sie ein GitHub-Problem in einem der folgenden GitHub-Repositorys. Pull Requests sind auch willkommen.

GitHub-Repositorys Beschreibung
Azure/azure-sdk-for-java Dieses Repository enthält den Quellcode.
MicrosoftDocs/azure-dev-docs Dieses Repository enthält die Dokumentation.

Neuerungen in 4.0 seit 3.10.x

In dieser Dokumentation werden Änderungen von 4.0 seit 3.10 behandelt. Diese Hauptversion bietet bessere Sicherheit, schlankere Abhängigkeiten, Unterstützung für die Produktionsbereitschaft und vieles mehr.

Tipp

Weitere Informationen zur Migration zu 4.0 finden Sie im Migrationshandbuch für 4.0.

Die folgende Liste fasst einige der Änderungen zusammen, die Spring Cloud Azure 4.0 bereitstellt:

  • Eine einheitliche Entwicklungsumgebung mit einheitlichem Projektnamen, Artefakt-ID und Eigenschaften.
  • Vereinfachte Abhängigkeitsverwaltung mithilfe einer einzelnen spring-cloud-azure-dependencies BOM.
  • Erweiterte Azure-Support auf Spring Initializr, um Kafka, Event Hubs, Azure Cache für Redis und Azure-App Konfiguration abzudecken.
  • Neu aufgebaute Federmodulabhängigkeiten, um überschüssige Schichten und Verangle zu entfernen.
  • Managed Identity-Unterstützung für Azure-App Konfiguration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob und Storage Queue.
  • Fortgesetzte Unterstützung für Authentifizierungsmethoden im zugrunde liegenden Azure SDK aus unseren Spring-Bibliotheken, z. B. SAS-Token- und Tokenanmeldeinformationenauthentifizierung mit Service Bus und Event Hubs.
  • Die Anmeldeinformationskette ist jetzt standardmäßig aktiviert, sodass Anwendungen Anmeldeinformationen von Anwendungseigenschaften, Umgebungsvariablen, verwalteter Identität, IDEs usw. abrufen können. Weitere Informationen finden Sie im Abschnitt "DefaultAzureCredential " der Azure Identity-Clientbibliothek für Java.
  • Präzise Zugriffssteuerung auf Ressourcenebene (z. B. ServiceBus-Warteschlange), um eine bessere Sicherheitsgovernance und Die Einhaltung von IT-Richtlinien zu ermöglichen.
  • Weitere Optionen, die in spring-idiomatischer Weise verfügbar gemacht werden, indem die automatische Konfigurationsabdeckung von Azure SDK-Clients sowohl für synchrone als auch für asynchrone Szenarien erheblich verbessert wurde.
  • Integritätsindikatoren für Azure-App Konfiguration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue und Storage File hinzugefügt.
  • Spring Cloud Sleuth-Unterstützung für alle HTTP-basierten Azure-SDKs.

Migrationshandbuch für 4.0

Weitere Informationen zur Migration zu 4.0 finden Sie im Migrationshandbuch für 4.0.

Erste Schritte

Einrichten von Abhängigkeiten

Stücklisten

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

Hinweis

Wenn Sie Spring Boot 3.x verwenden, stellen Sie sicher, dass Sie die spring-cloud-azure-dependencies Version auf 5.8.0. Weitere Informationen zur spring-cloud-azure-dependencies Version finden Sie unter Welche Version von Spring Cloud Azure sollte ich verwenden.

Startabhängigkeiten

Spring Cloud Azure Starters sind eine Reihe praktischer Abhängigkeitsdeskriptoren, die in Ihre Anwendung aufgenommen werden sollen. Jeder Starter enthält alle Abhängigkeiten und transitiven Abhängigkeiten, die erforderlich sind, um mit der Verwendung ihres entsprechenden Spring Cloud Azure-Moduls zu beginnen. Diese Starter steigern Ihre Spring Boot-Anwendungsentwicklung mit Azure-Diensten.

Wenn Sie z. B. mit Spring und Azure Cosmos DB für die Datenpersistenz beginnen möchten, schließen Sie die spring-cloud-azure-starter-cosmos Abhängigkeit in Ihr Projekt ein.

In der folgenden Tabelle sind Anwendungsstarter aufgeführt, die von Spring Cloud Azure unter der com.azure.spring Gruppe bereitgestellt werden:

Name Beschreibung
spring-cloud-azure-starter Der Hauptstarter, einschließlich Unterstützung für die automatische Konfiguration.
spring-cloud-azure-starter-active-directory Der Start für die Verwendung von Microsoft Entra ID mit Spring Security.
spring-cloud-azure-starter-active-directory-b2c Der Start für die Verwendung von Azure Active Directory B2C mit Spring Security.
spring-cloud-azure-starter-appconfiguration Der Start für die Verwendung von Azure-App-Konfiguration.
spring-cloud-azure-starter-cosmos Der Start für die Verwendung von Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs Der Start für die Verwendung von Azure Event Hubs.
spring-cloud-azure-starter-keyvault Der Starter für die Verwendung von Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets Der Start für die Verwendung von Azure Key Vault Secrets.
spring-cloud-azure-starter-keyvault-certificates Der Start für die Verwendung von Azure Key Vault-Zertifikaten.
spring-cloud-azure-starter-servicebus Der Start für die Verwendung von Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms Der Start für die Verwendung von Azure Service Bus und JMS.
spring-cloud-azure-starter-storage Der Start für die Verwendung von Azure Storage.
spring-cloud-azure-starter-storage-blob Der Start für die Verwendung von Azure Storage Blob.
spring-cloud-azure-starter-storage-file-share Der Start für die Verwendung der Azure Storage File Share.
spring-cloud-azure-starter-storage-queue Der Start für die Verwendung der Azure Storage-Warteschlange.
spring-cloud-azure-starter-aktor Der Starter für die Verwendung des Spring Boot Stellglieds, das Produktionsfertige bietet.

In der folgenden Tabelle sind Die Starter für die Spring Data-Unterstützung aufgeführt:

Name Beschreibung
spring-cloud-azure-starter-data-cosmos Der Start für die Verwendung von Spring Data für Azure Cosmos DB.

In der folgenden Tabelle sind die Starter für die Unterstützung der Spring-Integration aufgeführt:

Name Beschreibung
spring-cloud-azure-starter-integration-eventhubs Der Start für die Verwendung von Azure Event Hubs und Spring Integration.
spring-cloud-azure-starter-integration-servicebus Der Start für die Verwendung von Azure Service Bus und Spring Integration.
spring-cloud-azure-starter-integration-storage-queue Der Start für die Verwendung von Azure Storage Queue und Spring Integration.

In der folgenden Tabelle sind Die Starter für spring Cloud Stream-Unterstützung aufgeführt:

Name Beschreibung
spring-cloud-azure-starter-stream-eventhubs Die Starter für die Verwendung von Azure Event Hubs und Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus Der Start für die Verwendung von Azure Service Bus und Spring Cloud Stream Binder.

In der folgenden Tabelle sind Die Starter für die MySQL-Unterstützung aufgeführt:

Name Beschreibung
spring-cloud-azure-starter-platform-mysql Die Starter für die Verwendung von Azure MySQLs und AKTIONEN über die Microsoft Entra-Authentifizierung.

In der folgenden Tabelle sind Die Starter für die PostgreSQL-Unterstützung aufgeführt:

Name Beschreibung
spring-cloud-azure-starter-servers-postgresql Die Starter für die Verwendung von Azure PostgreSQL und AKTIONEN über die Microsoft Entra-Authentifizierung.

Learning Spring Cloud Azure

Wir haben eine vollständige Liste der Beispiele für die Verwendung vorbereitet. Sie finden diese Beispiele unter Spring Cloud Azure Samples.