Příručka pro vývojáře Azure Spring Cloud

Spring je opensourcová aplikační architektura vyvinutá VMware, která poskytuje zjednodušený modulární přístup pro vytváření Java aplikací. Spring Cloud Azure je opensourcový projekt, který poskytuje bezproblémovou integraci Spring s Azure.

Další informace o podporovaných verzích najdete v tématu Mapování verzí.

Získání nápovědy

Pokud máte nějaké dotazy k této dokumentaci, vytvořte problém GitHub v jednom z následujících GitHub úložišť. Žádosti o přijetí změn jsou také vítány.

úložiště GitHub	Popis
Azure/azure-sdk-for-java	Toto úložiště obsahuje zdrojový kód.
Azure-Samples/azure-spring-boot-samples	Toto úložiště obsahuje související ukázky.
MicrosoftDocs/azure-dev-docs	Toto úložiště obsahuje dokumentaci.

Začínáme

Nastavení závislostí

Kusovník materiálu (KUSOVNÍK)

Pokud používáte Maven, přidejte do souboru pom.xml v části dependencyManagement kusovník, jak je znázorněno v následujícím příkladu. Při použití kusovníku nemusíte zadávat verze pro žádné závislosti Mavenu, protože správa verzí se deleguje do kusovníku.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>7.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Pomocí Gradle můžete importovat spring-cloud-azure-dependencies kusovníku následujícími způsoby:

• Použijte nativní podporu kusovníku Gradle přidáním závislostí, jak je znázorněno v následujícím příkladu:

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "4.0.1"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Použijte modul plug-in io.spring.dependency-management a naimportujte kusovník v dependencyManagement, jak je znázorněno v následujícím příkladu:

  plugins {
      id("io.spring.dependency-management") version "1.1.7"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Další informace naleznete v Spring Boot Gradle Referenční příručka modulu plug-in.

Poznámka

Pokud používáte Spring Boot 4.0.x, nezapomeňte nastavit spring-cloud-azure-dependencies verzi na 7.1.0.

Pokud používáte Spring Boot 3.5.x, nezapomeňte nastavit spring-cloud-azure-dependencies verzi na 6.1.0hodnotu.

Pokud používáte Spring Boot 3.1.x-3.5.x, nezapomeňte nastavit spring-cloud-azure-dependencies verzi na 5.25.0hodnotu .

Pokud používáte Spring Boot 2.x, nezapomeňte nastavit spring-cloud-azure-dependencies verzi na 4.20.0.

Tato faktura materiálu (BOM) by měla být nakonfigurována v <dependencyManagement> části vašeho pom.xml souboru. Tím zajistíte, že všechny závislosti Spring Cloud Azure budou používat stejnou verzi.

Další informace o verzi použité pro tento kusovník najdete v tématu Která verze Spring Cloudu Azure Měla bych použít.

Počáteční závislosti

Úvodní Azure Spring Cloud jsou sada pohodlných popisovačů závislostí, které se mají zahrnout do vaší aplikace. Každá úvodní sada obsahuje všechny závislosti a tranzitivní závislosti potřebné k zahájení používání odpovídajícího modulu Azure Spring Cloud. Tyto úvodní sady zvyšují vývoj aplikací Spring Boot pomocí služeb Azure.

Pokud například chcete začít používat Spring a Azure Cosmos DB pro trvalost dat, zahrňte do projektu závislost spring-cloud-azure-starter-cosmos.

V následující tabulce jsou uvedeny úvodní sady aplikací poskytované aplikací Spring Cloud Azure ve skupině com.azure.spring:

Jméno	Popis
Spring-cloud-Azure-starter	Základní sada, včetně podpory automatické konfigurace.
Spring-Cloud-Azure-Starter-active-Directory	Úvodní sada pro použití Microsoft Entra ID s Spring Security.
spring-cloud-azure-starter-active-directory-b2c	Úvodní sada pro použití Azure Active Directory B2C s Spring Security.
spring-cloud-azure-starter-appconfiguration	Začátek pro použití Azure App Configuration.
spring-cloud-azure-starter-appconfiguration-config	Úvodní sada pro použití konfigurace Azure App Configuration.
spring-cloud-azure-starter-kosmos	Začátek pro použití Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	Úvodní sada pro použití Azure Event Hubs.
spring-cloud-azure-starter-eventgrid	Začátek pro použití Azure Event Grid.
spring-cloud-azure-starter-keyvault	Začátek pro použití Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets	Začátek používání tajných kódů Azure Key Vault.
spring-cloud-azure-starter-keyvault-jca	Začátek použití Azure Key Vault JCA.
Spring-Cloud-Azure-Starter-keyvault-certifikáty	Úvodní sada pro použití Azure Key Vault Certifikáty.
spring-cloud-azure-starter-servicebus	Začátek pro použití Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms	Úvodní sada pro použití Azure Service Bus a JMS.
spring-cloud-azure-starter-storage	Začátek pro použití Azure Storage.
spring-cloud-azure-starter-storage-blob	Začátek použití Azure Storage objektu blob.
spring-cloud-azure-starter-storage-file-share	Úvodní sada pro použití sdílené složky Azure Storage.
Spring-cloud-azure-starter-storage-queue	Úvodní sada pro použití Azure Storage Fronty.
spring-cloud-azure-starter-poháněcí zařízení	Úvodní sada pro použití poháněcího zařízení Spring Boot, která poskytuje funkce připravené pro produkční prostředí.

Následující tabulka obsahuje úvodní informace o podpoře Spring Data:

Jméno	Popis
spring-cloud-azure-starter-data-cosmos	Úvodní sada pro použití Spring Data pro Azure Cosmos DB

Následující tabulka obsahuje úvodní informace o podpoře Spring Data Redis:

Jméno	Popis
spring-cloud-azure-starter-data-redis-lettuce	Úvodní sada pro použití Spring Data a Azure Cache for Redis s Lettuce.

Následující tabulka obsahuje úvodní informace o podpoře integrace Spring:

Jméno	Popis
spring-cloud-azure-starter-integration-eventhubs	Úvodní sada pro použití Azure Event Hubs a integrace spring.
spring-cloud-azure-starter-integration-servicebus	Úvodní sada pro použití Azure Service Bus a integrace Springu.
spring-cloud-azure-starter-integration-storage-queue	Úvodní sada pro použití Azure Storage fronty a integrace springu.

Následující tabulka obsahuje úvodní informace o podpoře Spring Cloud Streamu:

Jméno	Popis
spring-cloud-azure-starter-stream-eventhubs	Úvodní sada pro použití Azure Event Hubs a Spring Cloud Stream Binderu
spring-cloud-azure-starter-stream-servicebus	Úvodní sada pro použití Azure Service Bus a Spring Cloud Stream Binderu

Následující tabulka obsahuje úvodní informace o podpoře MySQL:

Jméno	Popis
„spring-cloud-azure-starter-jdbc-mysql“	Začátek použití Azure mySQLs a JDBC prostřednictvím ověřování Microsoft Entra.

Následující tabulka obsahuje úvodní informace o podpoře PostgreSQL:

Jméno	Popis
spring-cloud-azure-starter-jdbc-postgresql	Začátek použití Azure PostgreSQL a JDBC prostřednictvím ověřování Microsoft Entra.

Výukové Azure Spring Cloud

Úplný seznam ukázek, které zobrazují využití, najdete v tématu Spring Cloud Azure Samples.

Novinky ve verzi 4.0 od verze 3.10.x

Tato dokumentace popisuje změny provedené ve verzi 4.0 od verze 3.10. Tato hlavní verze přináší lepší zabezpečení, štíhlé závislosti, podporu připravenosti na produkční prostředí a další.

Spropitné

Další informace o migraci na verzi 4.0 najdete v průvodci migrací verze 4.0.

Následující seznam shrnuje některé změny, které poskytuje Spring Cloud Azure 4.0:

• Jednotné vývojové prostředí s jednotným názvem projektu, ID artefaktu a vlastnostmi.
• Zjednodušená správa závislostí pomocí jediného kusovníku spring-cloud-azure-dependencies
• Rozbalené Azure support na Spring Initializr pro Kafka, Event Hubs, Azure Cache for Redis a Azure App Configuration.
• Změna závislostí modulu Spring pro odebrání nadbytečných vrstev a propletení
• Podpora spravované identity pro Azure App Configuration, službu Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, objekt blob úložiště a frontu úložiště.
• Průběžná podpora metod ověřování v podkladových Azure SDK z našich knihoven Spring, jako je token SAS a ověřování přihlašovacích údajů tokenů pomocí Service Bus a služby Event Hubs.
• Řetěz přihlašovacích údajů je teď ve výchozím nastavení povolený a umožňuje aplikacím získávat přihlašovací údaje z vlastností aplikace, proměnných prostředí, spravované identity, ides atd. Další informace najdete v části DefaultAzureCredential klientské knihovny Azure Identita pro Java.
• Podrobné řízení přístupu na úrovni prostředků (například fronta Service Bus) za účelem lepšího řízení zabezpečení a dodržování zásad IT.
• Další možnosti zpřístupněné prostřednictvím spring-idiomatic způsobu prostřednictvím vylepšeného pokrytí automatické konfigurace Azure SDK klientů pro synchronní i asynchronní scénáře.
• Přidání indikátorů stavu pro Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, objekt blob úložiště, frontu úložiště a soubor úložiště
• Spring Cloud Sleuth podporuje všechny Azure SDKs založené na protokolu HTTP.