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

  • Статья

Эта статья относится к: ✔️ версия 4.14.0 ✔️ версии 5.8.0

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

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

Справка

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

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

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

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

Совет

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

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

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

Руководство по миграции для версии 4.0

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

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

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

Спецификация (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>

Примечание.

Если вы используете Spring Boot 3.x, обязательно установите для нее spring-cloud-azure-dependencies значение 5.8.0. Дополнительные сведения о версии см. в spring-cloud-azure-dependencies статье "Какая версия Spring Cloud Azure должна использоваться".

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

Spring Cloud Azure Starters — это набор удобных дескрипторов зависимостей для включения в приложение. Каждый начальный элемент содержит все зависимости и транзитивные зависимости, необходимые для начала использования соответствующего модуля Azure Spring Cloud. Эти начальные средства повышают разработку приложений 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 с 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-cosmos Начало использования Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs Начальный элемент для использования Центры событий Azure.
spring-cloud-azure-starter-keyvault Начальный элемент для использования Azure Key Vault.
spring-cloud-azure-starter-keyvault-secret Начало использования секретов Azure Key Vault.
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 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

Мы подготовили полный список примеров для отображения использования. Эти примеры можно найти в Примерах Azure Spring Cloud.