Conectar o Cache Redis do Azure ao seu aplicativo no Azure Spring Apps

Nota

Os planos Basic, 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 obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

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

Este artigo aplica-se a:✅ Java ✅ C#

Este artigo aplica-se a:✅ Basic/Standard ✅ Enterprise

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

Pré-requisitos

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

Se você não tiver uma instância implantada do Azure Spring Apps, siga as etapas no Guia de início rápido: implantar seu primeiro aplicativo no Azure Spring Apps.

Prepare o seu projeto

Java

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

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

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

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

Poliglota

Todas as cadeias de conexão e credenciais são injetadas como variáveis de ambiente, que você pode referenciar no código do aplicativo.

Para obter os nomes das variáveis de ambiente padrão, consulte Integrar o Cache Redis do Azure ao Service Connector.

Conectar seu aplicativo ao Cache Redis do Azure

Conector de serviço

Nota

Por padrão, os Service Connectors 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 seu aplicativo Spring para se conectar a um banco de dados Redis com uma chave de acesso usando o az spring connection create comando, 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
   

   Nota

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

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

   Gorjeta

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

2. Como alternativa, você pode usar 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 fornece uma experiência interativa.

   1. Selecione sua instância do Azure Spring Apps no portal do Azure e selecione Aplicativos no menu de navegação. Escolha a aplicação que pretende ligar e, em seguida, selecione Conector de Serviço no menu de navegação.

   2. Selecione Criar.

   3. Na guia Noções básicas, para 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 Next: Authentication.

   4. Na guia Autenticação, escolha Cadeia de conexão. O Service Connector recupera automaticamente a chave de acesso da sua conta de banco de dados Redis. Selecione Next: Networking.

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

   6. No separador Rever + Criar, aguarde até que a validação seja aprovada e, em seguida, selecione Criar. A criação pode levar alguns minutos para ser concluída.

   7. Depois que a conexão entre seu aplicativo Spring e seu banco de dados Redis tiver sido gerada, você poderá vê-la na página Service Connector e selecionar o botão de desdobramento para visualizar as variáveis de conexão configuradas.

Terraform

O script Terraform a seguir mostra como configurar um aplicativo 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óximos passos

Neste artigo, você aprendeu como conectar seu aplicativo no Azure Spring Apps ao Cache do Azure para Redis. Para saber mais sobre como conectar serviços ao seu aplicativo, consulte Conectar-se a um Banco de Dados do Azure para instância do MySQL.