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

Nota

Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.

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 predefiniti delle variabili di ambiente, vedere Integrare cache di Azure per Redis con Service Connessione or.

Connessione l'app all'cache di Azure per Redis

Connessione or del servizio

Nota

Per impostazione predefinita, i Connessione or 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 Connessione or per la prima volta, iniziare eseguendo il comando az provider register --namespace Microsoft.ServiceLinker per registrare il provider di risorse service Connessione or.

   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 az spring comando 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 Connessione or nel menu di spostamento.

   2. Seleziona 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. Selezionare Avanti: Autenticazione.

   4. Nella scheda Autenticazione scegliere Connessione stringa di Connessione. Service Connessione or recupera automaticamente la chiave di accesso dall'account del database Redis. Al termine, 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 Service Connessione or e selezionare il pulsante di distribuzione per visualizzare le variabili di connessione configurate.

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 Connessione a un'istanza di Database di Azure per MySQL.