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

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.

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.

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.

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
}