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

Spring Cloud Azure integruje aplikace Spring Boot se službami Azure. Tato příručka pro vývojáře vysvětluje, jak spravovat závislosti, zvolit počáteční položky a používat ukázky ke zrychlení Java vývoje aplikací.

Další informace o podporovaných verzích najdete v článku Mapování verzí Spring.

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 (BOM)

Pokud používáte Maven, přidejte BOM do souboru pom.xml v části dependencyManagement, jak ukazuje následující příklad. Při použití BOM nemusíte uvádět verze u žádné ze závislostí Mavenu, protože BOM spravuje verze.

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

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

• Použijte nativní podporu BOM v Gradlu přidáním závislostí, jak ukazuje následující příklad.

  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 zásuvný modul io.spring.dependency-management a importujte BOM v dependencyManagement, jak ukazuje následující příklad.

  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 referenční příručce k pluginu Spring Boot Gradle.

Poznámka

Pokud používáte Spring Boot 4.0.x, nastavte verzi spring-cloud-azure-dependencies na 7.4.0.

Pokud používáte Spring Boot 3.5.x, nastavte verzi spring-cloud-azure-dependencies na 6.5.0.

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

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 BOM najdete v článku Kterou verzi Spring Cloud Azure mám použít.

Počáteční závislosti

Spring Cloud Azure Starters jsou praktická sada deskriptorů závislostí pro zahrnutí 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í starter, včetně podpory automatické konfigurace.
spring-cloud-azure-starter-active-directory	Základní balíček pro použití Microsoft Entra ID se 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	Úvod do používání Azure App Configuration.
spring-cloud-azure-starter-appconfiguration-config	Úvod do používání Azure App Configuration.
spring-cloud-azure-starter-cosmos	Úvod k používání Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	Úvod do používání služby Azure Event Hubs.
spring-cloud-azure-starter-eventgrid	Začátek pro použití Azure Event Grid.
spring-cloud-azure-starter-keyvault	Úvod do používání 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-certificates	Začínáme s certifikáty ve službě Azure Key Vault.
spring-cloud-azure-starter-servicebus	Začátek pro použití Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms	Úvod do používání Azure Service Bus a JMS.
spring-cloud-azure-starter-storage	Úvod do používání Azure Storage.
spring-cloud-azure-starter-storage-blob	Začínáme s Azure Blob Storage.
spring-cloud-azure-starter-storage-file-share	Úvod do používání sdílené složky Azure Storage.
spring-cloud-azure-starter-storage-queue	Úvod do používání fronty Azure Storage.
spring-cloud-azure-starter-actuator	Starter pro použití modulu Actuator ve Spring Boot, který poskytuje funkce připravené pro produkční nasazení.

Následující tabulka uvádí startery pro podporu 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 uvádí startery pro podporu 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 uvádí startéry pro podporu Spring Integration:

Jméno	Popis
spring-cloud-azure-starter-integration-eventhubs	Začínáme s Azure Event Hubs a Spring Integration.
spring-cloud-azure-starter-integration-servicebus	Starter pro práci se službou Azure Service Bus a frameworkem Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	Starter pro použití Azure Storage Queue a Spring Integration.

Následující tabulka uvádí startery pro podporu Spring Cloud Stream:

Jméno	Popis
spring-cloud-azure-starter-stream-eventhubs	Starter pro práci s Azure Event Hubs a Spring Cloud Stream Binderem
spring-cloud-azure-starter-stream-servicebus	Starter pro použití Azure Service Bus a Spring Cloud Stream Binder.

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.

Seznámení s platformou Spring Cloud Azure

Ú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. Toto zásadní vydání přináší lepší zabezpečení, méně závislostí, podporu pro nasazení do produkčního prostředí a další.

Tip

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 spring-cloud-azure-dependencies BOM.
• Rozšířili jsme podporu Azure v nástroji Spring Initializr o 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 pro spravovanou identitu pro Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Blob Storage a Queue Storage.
• 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.
• Jemně odstupňované řízení přístupu na úrovni prostředků (například fronty služby Service Bus) pro lepší správu zabezpečení a soulad se zásadami IT.
• Další možnosti jsou zpřístupněny způsobem odpovídajícím frameworku Spring díky rozšířenému pokrytí automatické konfigurace klientů Azure SDK pro synchronní i asynchronní scénáře.
• Byly přidány indikátory stavu pro Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Blob Storage, Queue Storage a File Storage.
• Spring Cloud Sleuth podporuje všechny Sady Azure SDK založené na protokolu HTTP.