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-dependenciesmodelu 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).