Руководство разработчика Azure Spring Cloud

Spring — это платформа приложений с открытым кодом, разработанная VMware, которая предоставляет упрощенный модульный подход для создания Java приложений. Spring Cloud Azure — это проект с открытым исходным кодом, который обеспечивает простую интеграцию Spring с Azure.

Дополнительные сведения о поддерживаемых версиях см. в разделе Сопоставления версийSpring.

Получение справки

Если у вас есть вопросы об этой документации, создайте проблему GitHub в одном из следующих репозиториев GitHub. Запросы на вытягивание также приветствуются.

репозитории GitHub	Описание
Azure/azure-sdk-for-java	Этот репозиторий содержит исходный код.
Azure-Samples/azure-spring-boot-samples	Этот репозиторий содержит связанные примеры.
Документация MicrosoftDocs/azure-dev-docs	Этот репозиторий содержит документацию.

Начало работы

Настройка зависимостей

Счет материалов (BOM)

Если вы используете Maven, добавьте BOM в файл pom.xml в разделе dependencyManagement, как показано в следующем примере. При использовании BOM вам не нужно указывать версии для любой из зависимостей Maven, так как управление версиями делегировано ВМ.

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

С помощью Gradle можно импортировать spring-cloud-azure-dependencies BOM следующим образом:

• Используйте встроенную поддержку BOM Gradle, добавив зависимости, как показано в следующем примере:

  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}"))
  }
  

• Используйте подключаемый модуль io.spring.dependency-management и импортируйте BOM в dependencyManagement, как показано в следующем примере:

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

Дополнительные сведения см. в справочном руководстве по подключаемым модулям Spring Boot Gradle.

Заметка

Если вы используете Spring Boot 4.0.x, обязательно установите версию, указанную в spring-cloud-azure-dependencies, на значение 7.2.0.

Если вы используете Spring Boot 3.5.x, обязательно задайте версию spring-cloud-azure-dependencies на 6.2.0.

Если вы используете Spring Boot 3.1.x-3.5.x, обязательно установите для нее spring-cloud-azure-dependencies значение.5.25.0

Если вы используете Spring Boot 2.x, обязательно установите версию spring-cloud-azure-dependencies на 4.20.0.

Эта ведомость материалов (BOM) должна быть сконфигурирована в <dependencyManagement> разделе файла pom.xml. Это гарантирует, что все зависимости Spring Cloud Azure используют одну и ту же версию.

Дополнительные сведения о версии, используемой для этого BOM, см. в разделе Which Version of Spring Cloud Azure Следует использовать.

Начальные зависимости

Spring Cloud Azure Starters — это набор удобных дескрипторов зависимостей для включения в приложение. Каждый начальный элемент содержит все зависимости и транзитивные зависимости, необходимые для начала использования соответствующего модуля Spring Cloud Azure. Эти начальные средства повышают разработку приложений Spring Boot с помощью служб Azure.

Например, если вы хотите приступить к работе с Spring и Azure Cosmos DB для сохраняемости данных, включите в проект зависимость spring-cloud-azure-starter-cosmos.

В следующей таблице перечислены начальные приложения, предоставляемые Spring Cloud Azure в группе com.azure.spring:

Имя	Описание
spring-cloud-azure-starter	Основной начальный элемент, включая поддержку автоматической настройки.
spring-cloud-azure-starter-active-directory	Начало использования Microsoft Entra ID с Spring Security.
spring-cloud-azure-starter-active-directory-b2c	Начало использования Azure Active Directory B2C с Spring Security.
spring-cloud-azure-starter-appconfiguration	Начало использования Конфигурация приложений Azure.
spring-cloud-azure-starter-appconfiguration-config	Начальный элемент для использования Конфигурация приложений Azure конфигурации.
spring-cloud-azure-starter-cosmos	Начальный элемент для использования Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs	Начальный элемент для использования Центры событий Azure.
spring-cloud-azure-starter-eventgrid	Начальный элемент для использования Сетка событий Azure.
spring-cloud-azure-starter-keyvault	Начальный элемент для использования Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets	Начальный элемент для использования секретов Azure Key Vault.
spring-cloud-azure-starter-keyvault-jca	Начало использования Azure Key Vault JCA.
spring-cloud-azure-starter-keyvault-certificates	Начальный элемент для использования сертификатов Azure Key Vault.
spring-cloud-azure-starter-servicebus	Начальный элемент для использования Служебная шина Azure.
spring-cloud-azure-starter-servicebus-jms	Начальный элемент для использования Служебная шина Azure и JMS.
spring-cloud-azure-starter-storage	Начальный элемент для использования служба хранилища Azure.
spring-cloud-azure-starter-storage-blob	Начальный элемент для использования служба хранилища Azure BLOB-объекта.
spring-cloud-azure-starter-storage-file-share	Начальный элемент для использования служба хранилища Azure общей папки.
spring-cloud-azure-starter-storage-queue	Начальный элемент для использования очереди служба хранилища Azure.
spring-cloud-azure-starter-actuator	Начальный элемент для использования Actuator Spring Boot, который предоставляет готовые к работе функции.

В следующей таблице перечислены начальные средства поддержки Spring Data:

Имя	Описание
spring-cloud-azure-starter-data-cosmos	Начало использования Spring Data для Azure Cosmos DB.

В следующей таблице перечислены начальные средства поддержки Spring Data Redis:

Имя	Описание
spring-cloud-azure-starter-data-redis-lettuce	Начало использования Spring Data и Кэш Azure для Redis с Lettuce.

В следующей таблице перечислены начальные средства поддержки Spring Integration:

Имя	Описание
spring-cloud-azure-starter-integration-eventhubs	Начальный элемент для использования Центры событий Azure и Spring Integration.
spring-cloud-azure-starter-integration-servicebus	Начало использования Служебная шина Azure и Spring Integration.
spring-cloud-azure-starter-integration-storage-queue	Начальная версия для использования служба хранилища Azure очереди и интеграции Spring.

В следующей таблице перечислены начальные средства поддержки Spring Cloud Stream:

Имя	Описание
spring-cloud-azure-starter-stream-eventhubs	Начало использования Центры событий Azure и Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus	Начало использования Служебная шина Azure и Spring Cloud Stream Binder.

В следующей таблице перечислены начальные средства поддержки MySQL:

Имя	Описание
spring-cloud-azure-starter-jdbc-mysql	Начало использования Azure MySQLs и JDBC с помощью проверки подлинности Microsoft Entra.

В следующей таблице перечислены начальные средства поддержки PostgreSQL:

Имя	Описание
spring-cloud-azure-starter-jdbc-postgresql	Начало использования Azure PostgreSQL и JDBC с помощью проверки подлинности Microsoft Entra.

Обучение Spring Cloud Azure

Полный список примеров, показывающих использование, см. в разделе Spring Cloud Azure Samples.

Новые возможности версии 4.0 с 3.10.x

В этой документации рассматриваются изменения, внесенные в версии 4.0 с 3.10. Этот основной выпуск обеспечивает более высокую безопасность, более зависимые зависимости, поддержку готовности к работе и многое другое.

Кончик

Дополнительные сведения о миграции на 4.0 см. в руководстве по миграции 4.0.

В следующем списке приведены некоторые изменения, которые предоставляет Spring Cloud Azure 4.0:

• Единый интерфейс разработки с унифицированным именем проекта, идентификатором артефакта и свойствами.
• Упрощенное управление зависимостями с помощью одного spring-cloud-azure-dependencies BOM.
• Развернутые поддержка Azure на Spring Initializr для покрытия Kafka, Центров событий, Кэш Azure для Redis и Конфигурация приложений Azure.
• Переключение зависимостей модуля Spring для удаления избыточных слоев и запутанности.
• Поддержка управляемых удостоверений для Конфигурация приложений Azure, Центров событий, служебная шина, Azure Cosmos DB, Key Vault, BLOB-объектов хранилища и очереди хранилища.
• Постоянная поддержка методов проверки подлинности в базовой Azure SDK из библиотек Spring, таких как маркер SAS и проверка подлинности учетных данных маркера с помощью служебная шина и Центров событий.
• Цепочка учетных данных теперь включена по умолчанию, позволяя приложениям получать учетные данные из свойств приложения, переменных среды, управляемых удостоверений, УДостоверений и т. д. Дополнительные сведения см. в разделе DefaultAzureCredential клиентской библиотеки Azure Identity для Java.
• Детализированный контроль доступа на уровне ресурсов (например, служебная шина очереди), чтобы обеспечить более эффективное управление безопасностью и соблюдение ИТ-политик.
• Дополнительные варианты, предоставляемые в идиоматических способах spring-idiomatic, благодаря улучшенному охвату автозаполнения клиентов Azure SDK для синхронных и асинхронных сценариев.
• Добавлены индикаторы работоспособности для Конфигурация приложений Azure, Центров событий, Azure Cosmos DB, Key Vault, BLOB-объектов хранилища, очереди хранилища и файла хранилища.
• Поддержка Spring Cloud Sleuth для всех Azure SDKs на основе HTTP.