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

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 qualquer spring.redis.* propriedade do ficheiro 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 .

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.

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.

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
}