Connettere cache di Azure per Redis all'applicazione in Azure Spring Apps

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a:✅ Java ✅ C#

Questo articolo si applica a:✅ Basic/Standard ✅ Enterprise

Invece di configurare manualmente le applicazioni Spring Boot, è possibile connettere automaticamente i servizi di Azure selezionati alle applicazioni usando Azure Spring Apps. Questo articolo illustra come connettere l'applicazione a cache di Azure per Redis.

Prerequisiti

• Istanza di Azure Spring Apps distribuita
• Un'istanza del servizio Cache di Azure per Redis
• Estensione Azure Spring Apps per l'interfaccia della riga di comando di Azure

Se non si dispone di un'istanza di Azure Spring Apps distribuita, seguire la procedura descritta in Avvio rapido: Distribuire la prima applicazione in Azure Spring Apps.

Preparare il progetto

Java

1. Aggiungere la dipendenza seguente al file di pom.xml del progetto:

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

2. Rimuovere tutte spring.redis.* le proprietà dal file application.properties

3. Aggiornare la distribuzione corrente usando az spring app update oppure crearne una nuova usando az spring app deployment create.

Poliglotta

Tutte le stringa di connessione e le credenziali vengono inserite come variabili di ambiente, a cui è possibile fare riferimento nel codice dell'applicazione.

Per i nomi delle variabili di ambiente predefinite, vedere Integrare cache di Azure per Redis con Service Connector.

Connettere l'app al cache di Azure per Redis

Connettore servizio

Nota

Per impostazione predefinita, i connettori di servizio vengono creati a livello di applicazione. Per eseguire l'override delle connessioni, è possibile creare di nuovo altre connessioni nelle distribuzioni.

1. Usare l'interfaccia della riga di comando di Azure per configurare l'app Spring per connettersi a un database Redis con una chiave di accesso usando il az spring connection create comando , come illustrato nell'esempio seguente.

   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 si usa Service Connector per la prima volta, iniziare eseguendo il comando az provider register --namespace Microsoft.ServiceLinker per registrare il provider di risorse di Service Connector.

   Se si usa Redis Enterprise, usare invece il az spring connection create redis-enterprise comando .

   Suggerimento

   Eseguire il comando az spring connection list-support-types --output table per ottenere un elenco dei servizi di destinazione e dei metodi di autenticazione supportati per Azure Spring Apps. Se il comando az spring non è riconosciuto dal sistema, verificare di aver installato l'estensione richiesta eseguendo az extension add --name spring.

2. In alternativa, è possibile usare il portale di Azure per configurare questa connessione completando i passaggi seguenti. Il portale di Azure offre le stesse funzionalità dell'interfaccia della riga di comando di Azure e offre un'esperienza interattiva.

   1. Selezionare l'istanza di Azure Spring Apps nel portale di Azure e quindi selezionare App dal menu di spostamento. Scegliere l'app da connettere e quindi selezionare Service Connector nel menu di spostamento.

   2. Selezionare Crea.

   3. Nella scheda Informazioni di base selezionare Cache per Redis per tipo di servizio. Scegliere una sottoscrizione e un server cache Redis. Compilare il nome del database Redis ("0" in questo esempio) e in tipo di client selezionare Java. Al termine, selezionare Avanti: Autenticazione.

   4. Nella scheda Autenticazione scegliere Stringa di connessione. Service Connector recupera automaticamente la chiave di accesso dall'account del database Redis. Selezionare Avanti: Rete.

   5. Nella scheda Rete selezionare Configura regole del firewall per abilitare l'accesso al servizio di destinazione e quindi selezionare Rivedi e crea.

   6. Nella scheda Rivedi e crea attendere il superamento della convalida e quindi selezionare Crea. Il completamento della creazione può richiedere alcuni minuti.

   7. Dopo aver generato la connessione tra l'app Spring il database Redis, è possibile visualizzarlo nella pagina Del connettore di servizi e selezionare il pulsante di distribuzione per visualizzare le variabili di connessione configurate.Once the connection between your Spring app your Redis database has been generated, you can see it in the Service Connector page and select the unfold button to view the configured connection variables.

Terraform

Lo script Terraform seguente illustra come configurare un'app Azure Spring Apps con cache di Azure per 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
}

Passaggi successivi

In questo articolo si è appreso come connettere l'applicazione in Azure Spring Apps a cache di Azure per Redis. Per altre informazioni sulla connessione dei servizi all'applicazione, vedere Connettersi a un'istanza di Database di Azure per MySQL.