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

Observação

Azure Spring Apps é o novo nome do serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns locais por um tempo enquanto trabalhamos para atualizar ativos como capturas de tela, vídeos e diagramas.

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 os serviços selecionados do Azure aos seus aplicativos usando os Aplicativos do Azure Spring. 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, que você pode referenciar no código do aplicativo.

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

Conectar 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, 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 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 Service Connector recupera automaticamente a chave de acesso da sua conta de 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 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 uma instância do Banco de Dados do Azure para MySQL.