Przewodnik dla deweloperów platformy Azure platformy Spring Cloud

Ten artykuł dotyczy: ✔️ wersja 4.14.0 ✔️ w wersji 5.8.0

Spring to platforma aplikacji typu open source opracowana przez oprogramowanie VMware, która zapewnia uproszczone, modułowe podejście do tworzenia aplikacji Java. Spring Cloud Azure to projekt open source, który zapewnia bezproblemową integrację platformy Spring z platformą Azure.

Aby uzyskać więcej informacji na temat obsługiwanych wersji, zobacz Mapowanie wersji spring.

Uzyskaj pomoc

Jeśli masz jakiekolwiek pytania dotyczące tej dokumentacji, utwórz problem z usługą GitHub w jednym z następujących repozytoriów usługi GitHub. Żądania ściągnięcia są również mile widziane.

Repozytoria usługi GitHub	opis
Azure/azure-sdk-for-java	To repozytorium przechowuje kod źródłowy.
MicrosoftDocs/azure-dev-docs	To repozytorium zawiera dokumentację.

Co nowego w wersji 4.0 od wersji 3.10.x

Ta dokumentacja obejmuje zmiany wprowadzone w wersji 4.0 od wersji 3.10. Ta główna wersja zapewnia lepsze zabezpieczenia, szczuplejsze zależności, obsługę gotowości produkcyjnej i nie tylko.

Napiwek

Aby uzyskać więcej informacji na temat migracji do wersji 4.0, zobacz Przewodnik migracji dla wersji 4.0.

Poniższa lista zawiera podsumowanie niektórych zmian zapewnianych przez platformę Spring Cloud Azure 4.0:

• Ujednolicone środowisko programistyczne z ujednoliconą nazwą projektu, identyfikatorem artefaktu i właściwościami.
• Uproszczone zarządzanie zależnościami przy użyciu pojedynczego spring-cloud-azure-dependencies modelu BOM.
• Rozszerzono pomoc techniczna platformy Azure na platformie Spring Initializr, aby uwzględnić platformę Kafka, usługę Event Hubs, usługę Azure Cache for Redis i aplikacja systemu Azure Configuration.
• Zależności modułu Spring z architekturą Rearchitected w celu usunięcia nadmiaru warstw i splątania.
• Obsługa tożsamości zarządzanej dla usługi aplikacja systemu Azure Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob i Storage Queue.
• Ciągła obsługa metod uwierzytelniania w podstawowym zestawie Azure SDK z naszych bibliotek Spring, takich jak token SAS i uwierzytelnianie poświadczeń tokenu za pomocą usług Service Bus i Event Hubs.
• Łańcuch poświadczeń jest teraz domyślnie włączony, umożliwiając aplikacjom uzyskiwanie poświadczeń z właściwości aplikacji, zmiennych środowiskowych, tożsamości zarządzanej, środowisk IDE itd. Aby uzyskać więcej informacji, zobacz sekcję DefaultAzureCredential biblioteki klienta tożsamości platformy Azure dla języka Java.
• Szczegółowa kontrola dostępu na poziomie zasobów (na przykład kolejka usługi Service Bus), aby umożliwić lepsze zarządzanie zabezpieczeniami i przestrzeganie zasad IT.
• Więcej opcji uwidocznionych w sposób spring-idiomatic poprzez znacznie ulepszone automatyczne pokrycie konfiguracji klientów zestawu Azure SDK zarówno synchronicznych, jak i asynchronicznych.
• Dodano wskaźniki kondycji aplikacja systemu Azure Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue i Storage File.
• Obsługa rozwiązania Spring Cloud Sleuth dla wszystkich zestawów SDK platformy Azure opartych na protokole HTTP.

Przewodnik migracji dla wersji 4.0

Aby uzyskać więcej informacji na temat migracji do wersji 4.0, zobacz Przewodnik migracji dla wersji 4.0.

Wprowadzenie

Konfigurowanie zależności

Lista składowa (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>

Uwaga

Jeśli używasz środowiska Spring Boot 3.x, pamiętaj, aby ustawić spring-cloud-azure-dependencies wersję na 5.8.0. Aby uzyskać więcej informacji na temat spring-cloud-azure-dependencies wersji, zobacz Która wersja platformy Spring Cloud powinna być używana przez platformę Azure.

Zależności początkowe

Spring Cloud Azure Starters to zestaw wygodnych deskryptorów zależności do uwzględnienia w aplikacji. Każdy starter zawiera wszystkie zależności i przejściowe zależności potrzebne do rozpoczęcia korzystania z odpowiedniego modułu platformy Azure spring cloud. Te szablony startowe zwiększają programowanie aplikacji Spring Boot za pomocą usług platformy Azure.

Jeśli na przykład chcesz rozpocząć korzystanie z platformy Spring i usługi Azure Cosmos DB na potrzeby trwałości danych, uwzględnij spring-cloud-azure-starter-cosmos zależność w projekcie.

W poniższej tabeli wymieniono szablony startowe aplikacji udostępniane przez platformę Spring Cloud Azure w com.azure.spring grupie:

Nazwa/nazwisko	opis
spring-cloud-azure-starter	Podstawowy starter, w tym obsługa automatycznej konfiguracji.
spring-cloud-azure-starter-active-directory	Początek korzystania z usługi Microsoft Entra ID z usługą Spring Security.
spring-cloud-azure-starter-active-directory-b2c	Początek korzystania z usługi Azure Active Directory B2C z zabezpieczeniami Spring.
spring-cloud-azure-starter-appconfiguration	Starter do korzystania z aplikacja systemu Azure Configuration.
spring-cloud-azure-starter-cosmos	Początek korzystania z usługi Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	Początek korzystania z usługi Azure Event Hubs.
spring-cloud-azure-starter-keyvault	Szablon startowy do korzystania z usługi Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets	Początek korzystania z wpisów tajnych usługi Azure Key Vault.
spring-cloud-azure-starter-keyvault-certificates	Starter do korzystania z certyfikatów usługi Azure Key Vault.
spring-cloud-azure-starter-servicebus	Początek korzystania z usługi Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms	Starter do korzystania z usług Azure Service Bus i JMS.
spring-cloud-azure-starter-storage	Początek korzystania z usługi Azure Storage.
spring-cloud-azure-starter-storage-blob	Początek korzystania z obiektu blob usługi Azure Storage.
spring-cloud-azure-starter-storage-file-share	Początek korzystania z udziału plików usługi Azure Storage.
spring-cloud-azure-starter-storage-queue	Początek korzystania z kolejki usługi Azure Storage.
spring-cloud-azure-starter-siłownik	Starter do korzystania z siłownika Spring Boot, który zapewnia gotowe do produkcji funkcje.

W poniższej tabeli wymieniono początkowe informacje o obsłudze rozwiązania Spring Data:

Nazwa/nazwisko	opis
spring-cloud-azure-starter-data-cosmos	Początek korzystania z usługi Spring Data dla usługi Azure Cosmos DB.

W poniższej tabeli wymieniono początkowe informacje o obsłudze integracji platformy Spring:

Nazwa/nazwisko	opis
spring-cloud-azure-starter-integration-eventhubs	Starter do korzystania z usług Azure Event Hubs i Spring Integration.
spring-cloud-azure-starter-integration-servicebus	Starter do korzystania z usług Azure Service Bus i Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	Początek korzystania z kolejki usługi Azure Storage i integracji spring.

W poniższej tabeli wymieniono początkowe informacje o obsłudze usługi Spring Cloud Stream:

Nazwa/nazwisko	opis
spring-cloud-azure-starter-stream-eventhubs	Narzędzie startowe do korzystania z usług Azure Event Hubs i Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus	Starter do korzystania z usług Azure Service Bus i Spring Cloud Stream Binder.

W poniższej tabeli wymieniono początkowe informacje o obsłudze bazy danych MySQL:

Nazwa/nazwisko	opis
spring-cloud-azure-starter-jdbc-mysql	Podstawowe informacje dotyczące korzystania z list Azure MySQLs i JDBC za pośrednictwem uwierzytelniania firmy Microsoft Entra.

W poniższej tabeli wymieniono początkowe informacje o obsłudze bazy danych PostgreSQL:

Nazwa/nazwisko	opis
spring-cloud-azure-starter-jdbc-postgresql	Podstawowe informacje dotyczące korzystania z usług Azure PostgreSQL i JDBC za pośrednictwem uwierzytelniania firmy Microsoft Entra.

Edukacja Spring Cloud Azure

Przygotowaliśmy pełną listę przykładów do pokazania użycia. Te przykłady można znaleźć w witrynie Spring Cloud Azure Samples (Przykłady platformy Azure dla platformy Spring Cloud).