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

Artículo
10/23/2023

Este artículo se aplica a: ✔️ Versión 4.14.0 ✔️ versión 5.8.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 y mucho más.

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 boM.
Se expandió Soporte técnico de Azure en Spring Initializr para cubrir Kafka, Event Hubs, Azure Cache for Redis y App de Azure Configuration.
Rediseñó las dependencias del módulo Spring para quitar capas y entrelazamiento excesivos.
Compatibilidad de identidad administrada con App de Azure Configuración, 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 pormenorizado 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 en una forma de spring-idioma a través de una cobertura de configuración automática significativamente mejorada de los clientes de Azure SDK para escenarios sincrónicos y asincrónicos.
Se han agregado indicadores de estado para App de Azure 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.14.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.8.0en . Para obtener 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 inicio 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 desea 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 inicio principal, incluida la compatibilidad con la configuración automática.
spring-cloud-azure-starter-active-directory	El inicio para usar microsoft Entra ID 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 App de Azure 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-actuador	El inicio 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 e Integración de Spring.
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	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 Microsoft Entra.

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 a través de la autenticación de Microsoft Entra.

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).

Compartir a través de