Guia do desenvolvedor do Spring Cloud Azure

  • Artigo

Este artigo aplica-se a: ✔️ Versão 4.14.0 Versão 5.8.0 ✔️

O Spring é uma estrutura de aplicativos de código aberto desenvolvida pela VMware que fornece uma abordagem simplificada e modular para a criação de aplicativos Java. O Spring Cloud Azure é um projeto de código aberto que fornece integração perfeita do Spring com o Azure.

Para obter mais informações sobre versões suportadas, consulte Mapeamento de versões do Spring.

Obter ajuda

Se você tiver alguma dúvida sobre esta documentação, crie um problema do GitHub em um dos seguintes repositórios do GitHub. Pull requests também são bem-vindos.

Repositórios GitHub Description
Azure/azure-sdk-for-java Este repositório contém o código-fonte.
MicrosoftDocs/azure-dev-docs Este repositório contém a documentação.

O que há de novo na versão 4.0 desde a versão 3.10.x

Esta documentação abrange as alterações feitas na versão 4.0 desde a versão 3.10. Esta versão principal traz melhor segurança, dependências mais enxutas, suporte para prontidão de produção e muito mais.

Gorjeta

Para obter mais informações sobre como migrar para a versão 4.0, consulte Guia de migração para a versão 4.0.

A lista a seguir resume algumas das alterações que o Spring Cloud Azure 4.0 fornece:

  • Uma experiência de desenvolvimento unificada, com nome de projeto unificado, ID de artefato e propriedades.
  • Gerenciamento de dependência simplificado usando uma única spring-cloud-azure-dependencies lista técnica.
  • Suporte expandido do Azure no Spring Initializr para abranger Kafka, Hubs de Eventos, Cache do Azure para Redis e Configuração de Aplicativo do Azure.
  • Dependências do módulo Spring rearquitetadas para remover camadas em excesso e emaranhamento.
  • Suporte de Identidade Gerenciada para Configuração de Aplicativo do Azure, Hubs de Eventos, Service Bus, Azure Cosmos DB, Cofre de Chaves, Blob de Armazenamento e Fila de Armazenamento.
  • Suporte contínuo para métodos de autenticação no SDK do Azure subjacente de nossas bibliotecas Spring, como token SAS e autenticação de credenciais de token com Service Bus e Hubs de Eventos.
  • A cadeia de credenciais agora está habilitada por padrão, permitindo que os aplicativos obtenham credenciais de propriedades do aplicativo, variáveis de ambiente, identidade gerenciada, IDEs e assim por diante. Para obter mais informações, consulte a seção DefaultAzureCredential da biblioteca de cliente do Azure Identity para Java.
  • Controle de acesso granular no nível de recursos (como fila do Service Bus) para permitir melhor governança de segurança e aderência às políticas de TI.
  • Mais opções expostas de uma forma idiomática Spring através de uma cobertura de configuração automática significativamente melhorada dos clientes do SDK do Azure para cenários síncronos e assíncronos.
  • Adicionados indicadores de integridade para Configuração de Aplicativo do Azure, Hubs de Eventos, Azure Cosmos DB, Cofre de Chaves, Blob de Armazenamento, Fila de Armazenamento e Arquivo de Armazenamento.
  • Suporte do Spring Cloud Sleuth para todos os SDKs do Azure baseados em HTTP.

Guia de migração para 4.0

Para obter mais informações sobre como migrar para a versão 4.0, consulte Guia de migração para a versão 4.0.

Introdução

Configuração de dependências

Lista de materiais (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>

Nota

Se estiver a utilizar o Spring Boot 3.x, certifique-se de que define a spring-cloud-azure-dependencies versão como 5.8.0. Para obter mais informações sobre a spring-cloud-azure-dependencies versão, consulte Qual versão do Spring Cloud Azure devo usar.

Dependências iniciais

O Spring Cloud Azure Starters é um conjunto de descritores de dependência convenientes para incluir em seu aplicativo. Cada starter contém todas as dependências e dependências transitivas necessárias para começar a usar seu módulo correspondente do Spring Cloud Azure. Esses iniciantes impulsionam o desenvolvimento do aplicativo Spring Boot com os serviços do Azure.

Por exemplo, se você quiser começar a usar o Spring e o Azure Cosmos DB para persistência de dados, inclua a spring-cloud-azure-starter-cosmos dependência em seu projeto.

A tabela a seguir lista os iniciadores de aplicativos fornecidos pelo Spring Cloud Azure no com.azure.spring grupo:

Nome Descrição
spring-cloud-azure-starter O motor de arranque principal, incluindo suporte de configuração automática.
spring-cloud-azure-starter-active-directory O ponto de partida para usar o Microsoft Entra ID com o Spring Security.
spring-cloud-azure-starter-active-directory-b2c O ponto de partida para usar o Azure Ative Directory B2C com o Spring Security.
spring-cloud-azure-starter-appconfiguration O ponto de partida para usar a Configuração de Aplicativo do Azure.
primavera-nuvem-azure-starter-cosmos O ponto de partida para usar o Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs O ponto de partida para usar os Hubs de Eventos do Azure.
spring-cloud-azure-starter-keyvault O Starter para usar o Azure Key Vault.
spring-cloud-azure-starter-keyvault-secrets O ponto de partida para usar os Segredos do Cofre da Chave do Azure.
spring-cloud-azure-starter-keyvault-certificates O ponto de partida para usar os Certificados do Azure Key Vault.
spring-cloud-azure-starter-servicebus O ponto de partida para usar o Barramento de Serviço do Azure.
spring-cloud-azure-starter-servicebus-jms O ponto de partida para usar o Barramento de Serviço do Azure e o JMS.
spring-cloud-azure-starter-storage O ponto de partida para usar o Armazenamento do Azure.
spring-cloud-azure-starter-storage-blob O ponto de partida para usar o Blob de Armazenamento do Azure.
spring-cloud-azure-starter-storage-file-share O ponto de partida para usar o Compartilhamento de Arquivos de Armazenamento do Azure.
spring-cloud-azure-starter-storage-queue O ponto de partida para usar a Fila de Armazenamento do Azure.
spring-cloud-azure-starter-atuador O acionador de partida para usar o atuador do Spring Boot, que fornece recursos prontos para produção.

A tabela a seguir lista os iniciadores para o suporte ao Spring Data:

Nome Descrição
spring-cloud-azure-starter-data-cosmos O início para usar o Spring Data para o Azure Cosmos DB.

A tabela a seguir lista os iniciadores para o suporte ao Spring Integration:

Nome Descrição
spring-cloud-azure-starter-integration-eventhubs O ponto de partida para usar os Hubs de Eventos do Azure e a Integração do Spring.
spring-cloud-azure-starter-integration-servicebus O ponto de partida para usar o Barramento de Serviço do Azure e a Integração Spring.
spring-cloud-azure-starter-integration-storage-queue O ponto de partida para usar a Fila de Armazenamento do Azure e a Integração do Spring.

A tabela a seguir lista os iniciantes para o suporte ao Spring Cloud Stream:

Nome Descrição
spring-cloud-azure-starter-stream-eventhubs Os iniciadores para usar os Hubs de Eventos do Azure e o Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus O ponto de partida para usar o Barramento de Serviço do Azure e o Spring Cloud Stream Binder.

A tabela a seguir lista os iniciantes para o suporte ao MySQL:

Nome Descrição
spring-cloud-azure-starter-jdbc-mysql Os iniciadores para usar o Azure MySQLs e JDBC por meio da autenticação do Microsoft Entra.

A tabela a seguir lista os iniciadores para suporte ao PostgreSQL:

Nome Descrição
spring-cloud-azure-starter-jdbc-postgresql Os iniciadores para usar o Azure PostgreSQL e JDBC por meio da autenticação do Microsoft Entra.

Aprendendo o Azure do Spring Cloud

Preparamos uma lista completa de amostras para mostrar o uso. Você pode encontrar esses exemplos em Spring Cloud Azure Samples.