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

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ✔️ Java ✔️ C#

Cet article s’applique au : Niveau ✔️ De base/Standard ✔️ Entreprise

Au lieu de configurer manuellement vos applications Spring Boot, vous pouvez connecter automatiquement les services Azure sélectionnés à vos applications à l’aide d’Azure Spring Apps. Cet article explique comment connecter votre application à Azure Cache for Redis.

Prérequis

• Une instance Azure Spring Apps déployée
• Une instance du service Cache Azure pour Redis
• L’extension Azure Spring Apps pour Azure CLI

Si vous n’avez pas d’instance Azure Spring Apps déployée, suivez les étapes décrites dans Démarrage rapide : Déployer votre première application sur Azure Spring Apps.

Préparation du projet

Java

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.

Polyglot

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.

Connecter votre application à Azure Cache pour Redis

Connecteur de service

Remarque

Par défaut, les connecteurs de service sont créés au niveau de l’application. Pour remplacer les connexions, vous pouvez créer à nouveau d’autres connexions dans les déploiements.

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.

Terraform

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
}

Étapes suivantes

Dans cet article, vous avez découvert comment connecter votre application dans Azure Spring Apps à Azure Cache pour Redis. Pour en savoir plus sur la connexion de services à votre application, consultez Connecter à une instance Azure Database pour MySQL.