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 aplicativo de software livre desenvolvida pela VMware que oferece 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 com suporte, 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. Solicitações de pull também são bem-vindas.

Repositórios GitHub Descrição
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 4.0 desde a 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.

Dica

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 do artefato e propriedades.
  • Gerenciamento simplificado de dependências usando uma única spring-cloud-azure-dependencies BOM.
  • 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 o excesso de camadas e emaranhamento.
  • Suporte de Identidade Gerenciada para Configuração de Aplicativo do Azure, Hubs de Eventos, Barramento de Serviço, 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 autenticação de token SAS e credencial 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 de aplicativos, 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 Barramento de Serviço) para permitir melhor controle de segurança e aderência às políticas de TI.
  • Mais opções expostas de forma idiomática do Spring por meio de uma cobertura de configuração automática significativamente aprimorada de 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

Configurando 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>

Observação

Se você estiver usando o Spring Boot 3.x, certifique-se de definir 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

Os Spring Cloud Azure Starters são um conjunto de descritores de dependência convenientes para incluir em seu aplicativo. Cada iniciante contém todas as dependências e dependências transitivas necessárias para começar a usar o 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 iniciador principal, incluindo suporte à configuração automática.
spring-cloud-azure-starter-active-directory O iniciador para usar o Microsoft Entra ID com o Spring Security.
spring-cloud-azure-starter-active-directory-b2c O iniciador para usar o Azure Active Directory B2C com o Spring Security.
spring-cloud-azure-starter-appconfiguration O iniciador para usar a Configuração de Aplicativo do Azure.
spring-cloud-azure-starter-cosmos O iniciador para usar o Azure Cosmos DB.
spring-cloud-azure-starter-eventhubs O iniciador para usar os Hubs de Eventos do Azure.
spring-cloud-azure-starter-keyvault O Starter para usar o Cofre de Chaves do Azure.
spring-cloud-azure-starter-keyvault-secrets O iniciador para usar os Segredos do Cofre de Chaves do Azure.
spring-cloud-azure-starter-keyvault-certificates O iniciador para usar os Certificados do Cofre de Chaves do Azure.
spring-cloud-azure-starter-servicebus O iniciador para usar o Barramento de Serviço do Azure.
spring-cloud-azure-starter-servicebus-jms O iniciador para usar o Barramento de Serviço do Azure e o JMS.
spring-cloud-azure-starter-storage O iniciador para usar o Armazenamento do Azure.
spring-cloud-azure-starter-storage-blob O iniciador para usar o Blob de Armazenamento do Azure.
spring-cloud-azure-starter-storage-file-share O iniciador para usar o Compartilhamento de Arquivos de Armazenamento do Azure.
spring-cloud-azure-starter-storage-queue O iniciador para usar a Fila de Armazenamento do Azure.
spring-cloud-azure-starter-actuator 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 iniciador 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 iniciador para usar os Hubs de Eventos do Azure e a Integração de Primavera.
spring-cloud-azure-starter-integration-servicebus O iniciador para usar o Barramento de Serviço do Azure e a Integração de Mola.
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 iniciantes para usar os Hubs de Eventos do Azure e o Spring Cloud Stream Binder.
spring-cloud-azure-starter-stream-servicebus O iniciador para usar o Barramento de Serviço do Azure e o Spring Cloud Stream Binder.

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

Nome Descrição
spring-cloud-azure-starter-jdbc-mysql Os iniciantes para usar MySQLs do Azure 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 princípios iniciais para usar o Azure PostgreSQL e JDBC por meio da autenticação do Microsoft Entra.

Aprendendo o Spring Cloud Azure

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