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

Remarque

Azure Spring Apps est le nouveau nom du service Azure Spring Cloud. Bien que le service ait un nouveau nom, vous verrez l’ancien nom à divers endroits pendant un certain temps, car nous travaillons à mettre à jour les ressources telles que les captures d’écran, les vidéos et les diagrammes.

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 pour 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.

Polyglotte

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

Pour connaître les noms de variables d’environnement par défaut, consultez Intégrer Azure Cache pour Redis à Service Connecter or.

Connecter votre application au Azure Cache pour Redis

Connecteur de service

Remarque

Par défaut, les Connecter ors de service sont créés au niveau de l’application. Pour remplacer les connexions, vous pouvez créer 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 la 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. Le Connecter or de service 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 appris à 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 de Azure Database pour MySQL.