Connecter à Azure Cache pour Redis à votre application dans Azure Spring Apps

1. Ajoutez la dépendance suivante au fichier pom.xml de votre projet :

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

2. Supprimez toutes les propriétés spring.redis.* du fichier application.properties.

3. Mettez à jour le déploiement actuel avec az spring app update ou créez un déploiement avec az spring app deployment create.

Toutes les chaînes de connexion et informations d’identification sont injectées en tant que variables d’environnement que vous pouvez référencer dans le code de votre application.

Pour connaître les noms des variables d’environnement par défaut, consultez Intégrer Azure Cache pour Redis au connecteur de services.

1. Utilisez Azure CLI pour configurer votre application Spring afin qu’elle se connecte à une base de données Redis avec une clé d’accès à l’aide de la commande az spring connection create, comme illustré dans l’exemple suivant.

   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
   

   Remarque

   Si vous utilisez Service Connector pour la première fois, commencez par exécuter la commande az provider register --namespace Microsoft.ServiceLinker pour inscrire le fournisseur de ressources Service Connector.

   Si vous utilisez Redis Enterprise, utilisez la commande az spring connection create redis-enterprise à la place.

   Conseil

   Exécutez la commande az spring connection list-support-types --output table pour obtenir la liste des méthodes d’authentification et services cibles pris en charge pour Azure Spring Apps. Si la commande az spring n’est pas reconnue par le système, vérifiez que vous avez installé l’extension requise en exécutant az extension add --name spring.

2. Vous pouvez également utiliser le portail Azure pour configurer cette connexion en effectuant les étapes suivantes. Le Portail Microsoft Azure fournit les mêmes fonctionnalités qu’Azure CLI, et offre une expérience interactive.

   1. Sélectionnez votre instance Azure Spring Apps dans le portail Azure, puis sélectionnez Applications dans le menu de navigation. Choisissez l’application que vous souhaitez connecter, puis sélectionnez Service Connector dans le menu de navigation.

   2. Sélectionnez Créer.

   3. Sous l’onglet Informations de base, comme type de service, sélectionnez Cache pour Redis. Choisissez un abonnement et un serveur de cache Redis. Renseignez le nom de la base de données Redis (« 0 » dans cet exemple) et, comme type de client, sélectionnez Java. Sélectionnez Suivant : authentification.

   4. Sous l’onglet Authentification, choisissez Chaîne de connexion. Service Connector récupère automatiquement la clé d’accès à partir de votre compte de base de données Redis. Sélectionnez Suivant : Réseau.

   5. Sous l’onglet Réseau, sélectionnez Configurer les règles de pare-feu pour activer l’accès au service cible, puis Vérifier + créer.

   6. Sous l’onglet Vérifier + créer, attendez la validation, puis sélectionnez Créer. La création peut prendre quelques minutes.

   7. Une fois la connexion entre votre application Spring et votre base de données Redis générée, vous pouvez la voir dans la page Service Connector et sélectionner le bouton de développement pour afficher les variables de connexion configurées.

Le script Terraform suivant montre comment configurer une application Azure Spring Apps avec Azure Cache pour 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
}