Spring Cloud Azure developer guide

Spring é uma framework de aplicações open-source desenvolvida pela VMware que oferece uma abordagem simplificada e modular para a criação de aplicações Java. O Spring Cloud Azure é um projeto open-source que proporciona integração perfeita do Spring com o Azure.

Para mais informações sobre versões suportadas, consulte Spring Versions Mapping.

Obter ajuda

Se tiver alguma dúvida sobre esta documentação, crie uma edição no GitHub num dos seguintes repositórios do GitHub. Pull requests também são bem-vindos.

Primeiros passos

Configuração de dependências

Lista de materiais (BOM)

Se você usar o Maven, adicione a lista técnica ao arquivo pom.xml na seção dependencyManagement, conforme mostrado no exemplo a seguir. Ao usar a BOM, não é necessário especificar versões para nenhuma das dependências do Maven porque o controle de versão é delegado à BOM.

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

Com o Gradle, você pode importar a lista técnica de spring-cloud-azure-dependencies das seguintes maneiras:

• Use o suporte nativo de listas de materiais da Gradle adicionando dependências, como mostrado no seguinte exemplo:

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "4.0.1"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Use o plug-in io.spring.dependency-management e importe a lista técnica em dependencyManagement, conforme mostrado no exemplo a seguir:

  plugins {
      id("io.spring.dependency-management") version "1.1.7"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Para obter mais informações, consulte Spring Boot Gradle Plugin Reference Guide.

Dependências iniciais

Os Spring Cloud Azure Starters são um conjunto de descritores de dependência convenientes para incluir na sua aplicação. Cada starter contém todas as dependências e dependências transitivas necessárias para começar a usar o seu correspondente módulo Spring Cloud Azure. Estes iniciais potenciam o desenvolvimento da sua aplicação Spring Boot com os serviços do Azure.

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

A tabela seguinte lista os iniciadores de aplicações fornecidos pela Spring Cloud Azure no grupo com.azure.spring:

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

A tabela seguinte lista os iniciais para suporte ao Spring Data Redis:

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

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

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

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

Aprender Spring Cloud Azure

Para uma lista completa de amostras que mostram a utilização, consulte Spring Cloud Azure Samples.

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.

A lista seguinte resume algumas das alterações que o Spring Cloud Azure 4.0 oferece:

• Uma experiência de desenvolvimento unificada, com nome de projeto unificado, ID de artefato e propriedades.
• Gerenciamento simplificado de dependências usando uma única lista técnica de spring-cloud-azure-dependencies.
• Expandido Azure support no Spring Initializr para cobrir Kafka, Event Hubs, Azure Cache for Redis e Azure App Configuration.
• Dependências do módulo Spring rearquitetadas para remover camadas em excesso e emaranhamento.
• Suporte de Identidade Gerida para Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob e Storage Queue.
• Suporte contínuo para métodos de autenticação no Azure SDK subjacente das nossas bibliotecas Spring, como tokens SAS e autenticação de credenciais de token com Service Bus e Event Hubs.
• 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 mais informações, consulte a secção DefaultAzureCredential da biblioteca cliente de identidade Azure para Java.
• Controlo de acesso granular ao nível dos recursos (como a fila do Service Bus) para permitir uma melhor governação de segurança e adesão às políticas de TI.
• Mais opções expostas de forma Spring-idiomática através de uma melhor cobertura de configuração automática dos clientes Azure SDK para cenários síncronos e assíncronos.
• Adicionaram indicadores de saúde para Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue e Storage File.
• Suporte Spring Cloud Sleuth para todos os Azure SDKs baseados em HTTP.