Guia do programador do Spring Cloud Azure

O Spring Cloud Azure integra aplicações Spring Boot com os serviços do Azure. Este guia para programadores explica como gerir dependências, escolher iniciais e usar exemplos para acelerar o desenvolvimento de aplicações Java.

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 utilizar o Maven, adicione a BOM ao seu ficheiro pom.xml na secção dependencyManagement, conforme mostrado no exemplo seguinte. Quando usas o BOM, não tens de especificar versões para nenhuma das dependências do Maven, porque o BOM gere as versões.

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

Com o Gradle, pode importar a BOM spring-cloud-azure-dependencies das seguintes formas:

• Utilize o suporte nativo a BOM do Gradle, adicionando as dependências conforme ilustrado 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}"))
  }
  

• Utilize o plug-in io.spring.dependency-management e importe o BOM em dependencyManagement, como 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 starters facilitam o desenvolvimento da sua aplicação Spring Boot com 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 starters para o suporte do 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.
• Gestão simplificada de dependências utilizando um único BOM spring-cloud-azure-dependencies.
• Foi expandido o suporte do Azure no Spring Initializr para abranger Kafka, Event Hubs, Cache do Azure para 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 aos métodos de autenticação no SDK subjacente do Azure utilizado pelas nossas bibliotecas Spring, como a autenticação com token SAS e a autenticação com credenciais de token no Service Bus e no 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 disponibilizadas de forma idiomática no Spring, através de uma maior cobertura da configuração automática dos clientes do SDK do Azure, tanto para cenários síncronos como 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 SDKs do Azure baseados em HTTP.