Conexión de Azure Cache for Redis a una aplicación de Azure Spring Apps

Nota:

Los planes Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de jubilación de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte Migrar el consumo estándar y el plan dedicado de Azure Spring Apps a Azure Container Apps.

Este artículo se aplica a: ✔️ Java ✔️ C#

La información de este artículo puede ponerse en práctica en: ✔️ Básico o Estándar ✔️ Enterprise

En lugar de configurar manualmente las aplicaciones de Spring Boot, puede conectar automáticamente servicios de Azure seleccionados a las aplicaciones mediante Azure Spring Apps. En este artículo se muestra cómo conectar la aplicación a Azure Cache for Redis.

Requisitos previos

• Una instancia de Azure Spring Apps implementada
• Una instancia de servicio de Azure Cache for Redis
• Extensión de Azure Spring Apps para la CLI de Azure

Si no tiene una instancia implementada de Azure Spring Apps, siga los pasos descritos en el Inicio rápido: Implementación de la primera aplicación en Azure Spring Apps.

Preparación del proyecto

Java

1. Agregue la siguiente dependencia al archivo pom.xml del proyecto:

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

2. Quite todas las propiedades spring.redis.*del archivo application.properties.

3. Actualice la implementación actual mediante az spring app update o cree una mediante az spring app deployment create.

Polyglot

Todas las cadenas de conexión y las credenciales se insertan como variables de entorno, a las que puede hacer referencia en el código de la aplicación.

Para conocer los nombres de variables de entorno predeterminados, consulte Integración de Azure Cache for Redis con Service Connector.

Conexión de la aplicación a Azure Cache for Redis

Conector de servicio

Nota:

De forma predeterminada, los conectores de servicio se crean en el nivel de aplicación. Para invalidar las conexiones, puede volver a crear otras conexiones en las implementaciones.

1. Use la CLI de Azure para configurar la aplicación Spring para conectarse a una base de datos de Redis con una clave de acceso mediante el comando az spring connection create, como se muestra en el ejemplo siguiente.

   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:

   Si usa Service Connector por primera vez, empiece ejecutando el comando az provider register --namespace Microsoft.ServiceLinker para registrar el proveedor de recursos de Service Connector.

   Si usa Redis Enterprise, use el comando az spring connection create redis-enterprise en su lugar.

   Sugerencia

   Ejecute el comando az spring connection list-support-types --output table para obtener una lista de los servicios de destino compatibles con Azure Spring Apps y los métodos de autenticación. Si el sistema no reconoce el comando az spring, compruebe que ha instalado la extensión necesaria mediante la ejecución de az extension add --name spring.

2. Como alternativa, puede usar Azure Portal para configurar esta conexión completando los pasos siguientes. Azure Portal proporciona las mismas funcionalidades que la CLI de Azure y una experiencia interactiva.

   1. Seleccione la instancia de Azure Spring Apps en Azure Portal y, después, seleccione Aplicaciones en el menú de navegación. Elija la aplicación que quiere conectar y, luego, seleccione Service Connector en el menú de navegación.

   2. Seleccione Crear.

   3. En la pestaña Aspectos básicos, en el tipo de servicio, seleccione Cache for Redis. Elija una suscripción y un servidor de caché de Redis. Rellene el nombre de la base de datos de Redis ("0" en este ejemplo) y, en tipo de cliente, seleccione Java. Seleccione Siguiente: Autenticación.

   4. En la pestaña Autenticación, elija Cadena de conexión. Service Connector recupera automáticamente la clave de acceso de la cuenta de base de datos de Redis. Seleccione Siguiente: Redes.

   5. En la pestaña Redes, seleccione Configurar reglas de firewall para habilitar el acceso al servicio de destino y, después, seleccione Revisar y crear.

   6. En la pestaña Revisar y crear, espere a que se complete la validación y después seleccione Crear. Este proceso puede tardar unos minutos.

   7. Una vez generada la conexión entre la aplicación de Spring y la base de datos de Redis, puede verla en la página Service Connector y seleccionar el botón de despliegue para ver las variables de conexión configuradas.

Terraform

El siguiente script de Terraform muestra cómo configurar una aplicación de Azure Spring Apps con Azure Cache for 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
}

Pasos siguientes

En este artículo, ha aprendido a conectar la aplicación en Azure Spring Apps a Azure Cache for Redis. Para más información sobre cómo conectar servicios a la aplicación, consulte Conexión a una instancia de Azure Database for MySQL.