Guía para desarrolladores de Spring Cloud para desarrolladores de Azure

  • Artículo

Este artículo se aplica a: ✔️ Versión 4.8.0 ✔️, versión 5.1.0

Spring es un marco de trabajo de aplicaciones de código abierto desarrollado por VMware que ofrece un método modular simplificado para crear aplicaciones Java. Spring Cloud Azure es un proyecto de código abierto que proporciona una integración perfecta de Spring con Azure.

Para obtener más información sobre las versiones admitidas, vea Asignación de versiones de Spring.

Obtener ayuda

Si tiene alguna pregunta sobre esta documentación, cree un problema de GitHub en uno de los siguientes repositorios de GitHub. También se admiten las solicitudes de incorporación de cambios.

Repositorios de GitHub Descripción
Azure/azure-sdk-for-java Este repositorio contiene el código fuente.
MicrosoftDocs/azure-dev-docs Este repositorio contiene la documentación.

Novedades de la versión 4.0 desde la versión 3.10.x

En esta documentación se tratan los cambios realizados en la versión 4.0 desde la versión 3.10. Esta versión principal aporta una mejor seguridad, dependencias más ajustadas, compatibilidad con la preparación de producción, etc.

Sugerencia

Para obtener más información sobre la migración a la versión 4.0, consulte Guía de migración para la versión 4.0.

En la lista siguiente se resumen algunos de los cambios que proporciona Spring Cloud Azure 4.0:

  • Una experiencia de desarrollo unificada, con el nombre de proyecto unificado, el identificador de artefacto y las propiedades.
  • Administración simplificada de dependencias mediante una sola spring-cloud-azure-dependencies lista de materiales.
  • Se expandió Soporte técnico de Azure en Spring Initializr para cubrir Kafka, Event Hubs, Azure Cache for Redis y Azure App Configuration.
  • Rediseñó las dependencias del módulo Spring para quitar capas y entrelazamiento excesivos.
  • Compatibilidad con identidades administradas para Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob y Cola de Storage.
  • Compatibilidad continua con los métodos de autenticación en el SDK de Azure subyacente de nuestras bibliotecas de Spring, como el token de SAS y la autenticación de credenciales de token con Service Bus y Event Hubs.
  • La cadena de credenciales ahora está habilitada de forma predeterminada, lo que permite a las aplicaciones obtener credenciales de las propiedades de la aplicación, las variables de entorno, la identidad administrada, los IDE, etc. Para más información, consulte la sección DefaultAzureCredential de la biblioteca cliente de Azure Identity para Java.
  • Control de acceso granular en el nivel de recurso (como la cola de Service Bus) para permitir una mejor gobernanza de seguridad y cumplimiento de las directivas de TI.
  • Más opciones expuestas de forma idiomática de Spring a través de una cobertura de configuración automática significativamente mejorada de los clientes del SDK de Azure para escenarios sincrónicos y asincrónicos.
  • Se han agregado indicadores de estado para Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue y Storage File.
  • Compatibilidad de Spring Cloud Sleuth con todos los SDK de Azure basados en HTTP.

Guía de migración para la versión 4.0

Para obtener más información sobre la migración a la versión 4.0, consulte Guía de migración para la versión 4.0.

Introducción

Configuración de dependencias

Lista de materiales (L. MAT)

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

Nota

Si usa Spring Boot 3.x, asegúrese de establecer la spring-cloud-azure-dependencies versión 5.1.0en . Para más información sobre la spring-cloud-azure-dependencies versión, consulte Qué versión de Spring Cloud Azure debería usar.

Dependencias de inicio

Spring Cloud Azure Starters es un conjunto de descriptores de dependencia convenientes que se van a incluir en la aplicación. Cada iniciador contiene todas las dependencias y dependencias transitivas necesarias para empezar a usar su módulo de Azure de Spring Cloud correspondiente. Estos inicios aumentan el desarrollo de aplicaciones de Spring Boot con servicios de Azure.

Por ejemplo, si quiere empezar a usar Spring y Azure Cosmos DB para la persistencia de datos, incluya la dependencia en el spring-cloud-azure-starter-cosmos proyecto.

En la tabla siguiente se enumeran los inicios de aplicaciones proporcionados por Spring Cloud Azure en el com.azure.spring grupo:

Nombre Descripción
spring-cloud-azure-starter El iniciador principal, incluida la compatibilidad con la configuración automática.
spring-cloud-azure-starter-active-directory El inicio para usar Azure Active Directory con Spring Security.
spring-cloud-azure-starter-active-directory-b2c El inicio para usar Azure Active Directory B2C con Spring Security.
spring-cloud-azure-starter-appconfiguration El inicio para usar Azure App Configuration.
spring-cloud-azure-starter-cosmos El inicio para usar Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs El inicio para usar Azure Event Hubs.
spring-cloud-azure-starter-keyvault Inicio para usar Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets El inicio para usar secretos de Azure Key Vault.
spring-cloud-azure-starter-keyvault-certificates El inicio para usar certificados de Azure Key Vault.
spring-cloud-azure-starter-servicebus El inicio para usar Azure Service Bus.
spring-cloud-azure-starter-servicebus-jms El inicio para usar Azure Service Bus y JMS.
spring-cloud-azure-starter-storage El inicio para usar Azure Storage.
spring-cloud-azure-starter-storage-blob El inicio para usar Azure Storage Blob.
spring-cloud-azure-starter-storage-file-share El inicio para usar el recurso compartido de archivos de Azure Storage.
spring-cloud-azure-starter-storage-queue El inicio para usar la cola de Azure Storage.
spring-cloud-azure-starter-actuator El iniciador para usar el accionador de Spring Boot, que proporciona características listas para producción.

En la tabla siguiente se enumeran los inicios para la compatibilidad con Spring Data:

Nombre Descripción
spring-cloud-azure-starter-data-cosmos El inicio para usar Spring Data para Azure Cosmos DB.

En la tabla siguiente se enumeran los inicios para la compatibilidad con Spring Integration:

Nombre Descripción
spring-cloud-azure-starter-integration-eventhubs El inicio para usar Azure Event Hubs y Spring Integration.
spring-cloud-azure-starter-integration-servicebus El inicio para usar Azure Service Bus e Integración de Spring.
spring-cloud-azure-starter-integration-storage-queue El inicio para usar La cola de Azure Storage e Integración de Spring.

En la tabla siguiente se enumeran los inicios para la compatibilidad con Spring Cloud Stream:

Nombre Descripción
spring-cloud-azure-starter-stream-eventhubs Los inicios para usar Azure Event Hubs y Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus El inicio para usar Azure Service Bus y Spring Cloud Stream Binder.

En la tabla siguiente se enumeran los inicios para la compatibilidad con MySQL:

Nombre Descripción
spring-cloud-azure-starter-jdbc-mysql Los inicios para usar Azure MySQLs y JDBC a través de la autenticación de Azure AD.

En la tabla siguiente se enumeran los inicios para la compatibilidad con PostgreSQL:

Nombre Descripción
spring-cloud-azure-starter-jdbc-postgresql Los inicios para usar Azure PostgreSQL y JDBC mediante la autenticación de Azure AD.

Aprendizaje de Spring Cloud en Azure

Hemos preparado una lista completa de ejemplos para mostrar el uso. Puede encontrar estos ejemplos en Spring Cloud Azure Samples (Ejemplos de Azure de Spring Cloud).