Conectar o Cache do Azure para Redis ao aplicativo nos Aplicativos Spring do Azure

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano Consumo Standard e dedicado será preterido a partir de 30 de setembro de 2024, com desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo aplica-se a: ✔️ Java ✔️ C#

Este artigo se aplica ao: ✔️ nível Básico/Standard ✔️ nível Enterprise

Em vez de configurar manualmente seus aplicativos do Spring Boot, você pode conectar automaticamente serviços selecionados do Azure aos seus aplicativos usando os Aplicativos Spring do Azure. Este artigo mostra como conectar seu aplicativo ao Cache do Azure para Redis.

Pré-requisitos

• Uma instância do Azure Spring Apps implantada
• Uma instância de serviço do Cache Redis do Azure
• A extensão do Azure Spring Apps da CLI do Azure

Caso não tenha uma instância do Azure Spring Apps, siga as etapas do Início Rápido: implantar seu primeiro aplicativo no Azure Spring Apps.

Preparar seu projeto

Java

1. Adicione a seguinte dependência ao arquivo pom.xml do projeto:

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
   </dependency>
   

2. Remova todas as propriedades spring.redis.* do arquivo application.properties

3. Atualize a implantação atual usando az spring app update ou crie uma implantação usando az spring app deployment create.

Poliglota

Todas as cadeias de conexão e credenciais são injetadas como variáveis de ambiente e é possível referenciar isso no código do aplicativo.

Para os nomes padrão de variáveis de ambiente, confira Integrar o Cache do Azure para Redis com o Conector de Serviço.

Conecta seu aplicativo ao Cache do Azure para Redis.

Conector do Serviço

Observação

Por padrão, os Conectores de Serviço são criados no nível do aplicativo. Para substituir as conexões, você pode criar outras conexões novamente nas implantações.

1. Use a CLI do Azure para configurar o aplicativo Spring para conectar-se a um banco de dados Redis com uma chave de acesso usando o comando az spring connection create, conforme mostrado no exemplo a seguir.

   az spring connection create redis \
       --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
       --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --deployment $DEPLOYMENT_NAME \
       --target-resource-group $REDIS_RESOURCE_GROUP \
       --server $REDIS_SERVER_NAME\
       --database $REDIS_DATABASE_NAME \
       --secret
   

   Observação

   Se você estiver usando o Conector de Serviço pela primeira vez, comece executando o comando az provider register --namespace Microsoft.ServiceLinker para registrar o provedor de recursos do Conector de Serviço.

   Se você estiver usando o Redis Enterprise, use o comando az spring connection create redis-enterprise.

   Dica

   Execute o comando az spring connection list-support-types --output table para obter uma lista de serviços de destino com suporte e os métodos de autenticação para os Aplicativos Spring do Azure. Se o comando az spring não for reconhecido pelo sistema, verifique se você instalou a extensão necessária executando az extension add --name spring.

2. Como alternativa, use o portal do Azure para configurar essa conexão, concluindo as etapas a seguir. O portal do Azure fornece os mesmos recursos que a CLI do Azure e oferece uma experiência interativa.

   1. Escolha sua instância do Aplicativos Spring do Azure no portal do Azure e selecione Aplicativos no menu de navegação. Escolha o aplicativo que você deseja conectar e selecione Conector de Serviço no menu de navegação.

   2. Selecione Criar.

   3. Na guia Noções básicas, para o tipo de serviço, selecione Cache para Redis. Escolha uma assinatura e um servidor de cache Redis. Preencha o nome do banco de dados Redis ("0" neste exemplo) e, em tipo de cliente, selecione Java. Selecione Próximo: Autenticação.

   4. Na guia Autenticação, escolha Cadeia de conexão. O Conector de Serviço recupera automaticamente a chave de acesso da sua conta do banco de dados Redis. Selecione Avançar: Rede.

   5. Na guia Rede, selecione Configurar regras de firewall para habilitar o acesso ao serviço de destino e, em seguida, selecione Examinar + Criar.

   6. Na guia Examinar + Criar, aguarde a validação ser aprovada e selecione Criar. A criação do registro pode levar alguns minutos para ser concluída.

   7. Depois que a conexão entre o aplicativo Spring e o banco de dados Redis tiver sido gerada, você poderá vê-la na página Conector de Serviço e selecionar o botão desdobrar para exibir as variáveis de conexão configuradas.

Terraform

O script do Terraform a seguir mostra como configurar um aplicativo do Azure Spring Apps com o Cache do Azure para Redis.

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-abc"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_redis_cache" "redis" {
  name                = "redis-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  capacity            = 0
  family              = "C"
  sku_name            = "Standard"
  enable_non_ssl_port = false
  minimum_tls_version = "1.2"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "${var.application_name}"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "${var.application_name}-app"
  resource_group_name = azurerm_resource_group.example.name
  service_name        = azurerm_spring_cloud_service.example.name
  is_public           = true
  https_only          = true
}

resource "azurerm_spring_cloud_java_deployment" "example" {
  name                = "default"
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  quota {
    cpu    = "2"
    memory = "4Gi"
  }
  instance_count      = 2
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.redis.host"     = azurerm_redis_cache.redis.hostname
    "spring.redis.password" = azurerm_redis_cache.redis.primary_access_key
    "spring.redis.port"     = "6380"
    "spring.redis.ssl"      = "true"
  }
}

resource "azurerm_spring_cloud_active_deployment" "example" {
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  deployment_name     = azurerm_spring_cloud_java_deployment.example.name
}

Próximas etapas

Neste artigo, você aprendeu a conectar seu aplicativo nos Aplicativos Spring do Azure ao Cache do Azure para Redis. Para saber mais sobre como conectar serviços ao seu aplicativo, confira Conectar a uma instância do Banco de Dados do Azure para MySQL.