Démarrage rapide : acheminer les événements Azure Cache pour Redis vers le point de terminaison web avec le Portail Azure

Azure Event Grid est un service de gestion d’événements pour le cloud. Dans ce guide de démarrage rapide, vous allez utiliser le portail Azure pour créer une instance d’Azure Cache pour Redis, vous abonner aux événements de cette instance, déclencher un événement et voir les résultats. En règle générale, vous envoyez des événements à un point de terminaison qui traite les données d’événement et entreprend des actions. Toutefois, pour simplifier ce guide de démarrage rapide, vous allez envoyer des événements à une application web qui va collecter et afficher les messages.

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

Une fois que vous aurez fini, vous verrez que les données d’événement ont été envoyées à l’application web.

Créer une instance de cache Azure Cache pour Redis

1. Dans le portail Azure, recherchez et sélectionnez Cache Azure pour Redis.

2. Dans la page Cache Azure pour Redis , sélectionnez Créer un>cache Azure pour Redis.

3. Sous l’onglet Informations de base de la page Nouveau cache Redis , configurez les paramètres suivants :

   • Abonnement : sélectionnez l'abonnement souhaité.
   • Groupe de ressources : sélectionnez un groupe de ressources, ou sélectionnez Créer et entrez un nouveau nom de groupe de ressources. La mise en place de toutes vos ressources d’application dans le même groupe de ressources vous permet de les gérer ou de les supprimer facilement ensemble.
   • Nom : entrez un nom de cache unique dans la région. Le nom doit :
     • Doit être une chaîne de 1 à 63 caractères.
     • Contiennent uniquement des chiffres, des lettres et des traits d’union.
     • Commencez et terminez par un nombre ou une lettre.
     • Ne pas contenir des traits d’union consécutifs.
   • Région : sélectionnez une région Azure près d’autres services qui utilisent votre cache.
   • Référence SKU du cache : sélectionnez une référence SKU pour déterminer les tailles disponibles, les performances et les fonctionnalités de votre cache.
   • Taille du cache : sélectionnez une taille de cache. Pour plus d’informations, consultez Présentation d’Azure Cache pour Redis.

   

4. Sélectionnez l’onglet Mise en réseau , ou sélectionnez Suivant : Mise en réseau.

5. Sous l’onglet Mise en réseau, sélectionnez une méthode de connectivité à utiliser pour le cache. Le point de terminaison privé est recommandé pour la sécurité. Si vous sélectionnez Point de terminaison privé, sélectionnez Ajouter un point de terminaison privé et créez le point de terminaison privé.

6. Sélectionnez l’onglet Avancé , ou sélectionnez Suivant : Avancé.

7. Dans le volet Avancé , configurez les options suivantes :

   • Sélectionnez Authentification Microsoft Entra ou Authentification par clés d’accès. L’authentification Microsoft Entra est activée par défaut.
   • Choisissez s’il faut activer le port non TLS.
   • Pour un cache Premium, vous pouvez configurer ou désactiver des zones de disponibilité. Vous ne pouvez pas désactiver les zones de disponibilité une fois le cache créé. Pour un cache Standard, les zones de disponibilité sont allouées automatiquement. Les zones de disponibilité ne sont pas disponibles pour la référence SKU de base.
   • Pour un cache Premium, configurez les paramètres pour le nombre de réplicas, le clustering et le nombre de partitions, l’identité managée affectée par le système et la persistance des données.

   L’image suivante montre l’onglet Avancé pour la référence SKU Standard.

   

   Important

   Utilisez l’ID Microsoft Entra avec des identités managées pour autoriser les demandes sur votre cache si possible. L’autorisation utilisant l’ID Microsoft Entra et l’identité managée offre une meilleure sécurité et est plus facile à utiliser que l’autorisation de clé d’accès partagé. Pour plus d’informations sur l’utilisation d’identités managées avec votre cache, consultez Utiliser Microsoft Entra ID pour l’authentification du cache.

8. Si vous le souhaitez, sélectionnez l’onglet Balises ou sélectionnez Suivant : Balises, puis entrez les noms et les valeurs des balises pour catégoriser vos ressources de cache.

9. Sélectionnez Vérifier + créer, puis une fois la validation réussie, sélectionnez Créer.

Le nouveau déploiement de cache prend plusieurs minutes. Vous pouvez surveiller la progression du déploiement sur la page Azure Cache pour Redis du portail. Lorsque l’état du cache s’affiche en cours d’exécution, le cache est prêt à être utilisé.

Créer un point de terminaison de message

Avant de nous abonner aux événements de l’instance de cache, créons le point de terminaison du message d’événement. En règle générale, le point de terminaison entreprend des actions en fonction des données d’événement. Pour simplifier ce guide de démarrage rapide, vous allez déployer une application web prédéfinie, qui affiche les messages d’événement. La solution déployée comprend un plan App Service, une offre App Service Web Apps et du code source en provenance de GitHub.

1. Sélectionnez Déployer sur Azure dans le fichier README de GitHub pour déployer la solution sur votre abonnement.

   

2. Dans la page Déploiement personnalisé, procédez comme suit :

   1. Pour Groupe de ressources, sélectionnez le groupe de ressources que vous avez créé au moment où vous avez créé l’instance de cache. Il sera plus facile pour vous de nettoyer une fois que vous aurez terminé le didacticiel en supprimant le groupe de ressources.
   2. Pour Nom du site, entrez un nom pour l’application web.
   3. Pour Nom du plan d’hébergement, entrez un nom pour le plan App Service à utiliser pour l’hébergement de l’application web.
   4. Cochez la case J’accepte les termes et conditions mentionnés ci-dessus.
   5. Sélectionnez Achat.

   Réglage	Valeur suggérée	Descriptif
   Abonnement	Dans la liste déroulante, sélectionnez votre abonnement.	L’abonnement dans lequel vous souhaitez créer cette application web.
   Groupe de ressources	Dans la liste déroulante, sélectionnez un groupe de ressources ou choisissez Créer nouveau, puis entrez un nouveau nom de groupe de ressources.	En plaçant toutes les ressources de votre application dans un seul groupe de ressources, vous pouvez facilement les gérer ou les supprimer ensemble.
   Nom du site	Entrez le nom de votre application web.	Cette valeur ne peut pas être vide.
   Nom du plan d’hébergement	Entrez le nom du plan App Service à utiliser pour héberger l’application web.	Cette valeur ne peut pas être vide.

3. Sélectionnez Alertes (icône représentant une cloche) dans le portail, puis Accéder au groupe de ressources.

   

4. Dans la page Groupe de ressources, dans la liste des ressources, sélectionnez l’application web que vous avez créée. Vous voyez également le plan App Service et l’instance de cache dans cette liste.

5. Dans la page App Service de votre application web, sélectionnez l’URL pour accéder au site web. L’URL doit être au format suivant : https://<your-site-name>.azurewebsites.net.

6. Confirmez que vous voyez le site, mais qu’aucun événement n’a encore été posté sur celui-ci.

   

Enregistrer le fournisseur de ressources Event Grid

Si vous n’avez pas déjà utilisé Event Grid auparavant, vous devez inscrire le fournisseur de ressources Event Grid. Si vous avez déjà utilisé Event Grid, passez à la section suivante.

Dans le portail Azure, procédez comme suit :

1. Sélectionner Abonnements dans le menu de gauche.

2. Sélectionnez l’abonnement que vous souhaitez utiliser pour Event Grid dans la liste des abonnements.

3. Dans la page Abonnement, sélectionnez Fournisseurs de ressources dans la section Paramètres du menu de gauche.

4. Recherchez Microsoft.EventGrid, puis assurez-vous que l’État est Non inscrit.

5. Sélectionnez Microsoft.EventGrid dans la liste des fournisseurs.

6. Sélectionnez Inscrire dans la barre de commandes.

   

7. Actualisez pour vous assurer que l’état de Microsoft.EventGrid est modifié en Inscrit.

   

S’abonner à l’instance d’Azure Cache pour Redis

Au cours de cette étape, vous vous abonnez à une rubrique pour indiquer à Event Grid les événements que vous souhaitez suivre, et où les envoyer.

1. Dans le portail, accédez à l’instance de cache que vous avez créée.

2. Dans la page Azure Cache pour Redis, sélectionnez Événements dans le menu de gauche.

3. Sélectionnez Webhook. Vous envoyez des événements à votre application de visionneuse, avec un webhook comme point de terminaison.

   

4. Dans la page Créer un abonnement aux événements, entrez ce qui suit :

   Réglage	Valeur suggérée	Descriptif
   Nom	Entrez un nom pour l’abonnement aux événements.	La valeur doit avoir une longueur comprise entre 3 et 64 caractères. Elle peut contenir uniquement des lettres, des nombres et des tirets.
   Types d’événement	Faites défiler la liste vers le bas, puis sélectionnez le ou les types d’événement à envoyer (push) vers votre destination. Pour ce guide de démarrage rapide, nous allons effectuer une mise à l’échelle de notre instance de cache.	La mise à jour corrective, la mise à l’échelle, l’importation et l’exportation sont les options disponibles.
   Type de point de terminaison	Sélectionnez Webhook.	Gestionnaire d’événements pour la réception de vos événements.
   Point de terminaison	Sélectionnez Sélectionner un point de terminaison, entrez l’URL de votre application web, ajoutez api/updates à l’URL de la page d’accueil (par exemple https://cache.azurewebsites.net/api/updates), puis sélectionnez Confirmer la sélection.	Il s’agit de l’URL de l’application web que vous avez créée.

5. À présent, dans la page Créer un abonnement aux événements, sélectionnez Créer pour créer l’abonnement aux événements.

6. Affichez à nouveau votre application web, et notez qu’un événement de validation d’abonnement lui a été envoyé. Sélectionnez l’icône en forme d’œil pour développer les données d’événements. Event Grid envoie l’événement de validation pour que le point de terminaison puisse vérifier qu’il souhaite recevoir des données d’événement. L’application web inclut du code pour valider l’abonnement.

   

Envoyer un événement à votre point de terminaison

Nous allons maintenant déclencher un événement pour voir comment Event Grid distribue le message à votre point de terminaison. Nous allons effectuer une mise à l’échelle de votre instance d’Azure Cache pour Redis.

1. Dans le portail Azure, accédez à votre instance d’Azure Cache pour Redis, puis sélectionnez Mettre à l’échelle dans le menu de gauche.

2. Sélectionnez le niveau tarifaire souhaité dans la page Mettre à l’échelle, puis Sélectionner.

   Vous pouvez choisir un niveau tarifaire différent avec les restrictions suivantes :

   • Vous ne pouvez pas passer d’un niveau de tarification supérieur à un niveau de tarification inférieur.
     • Vous ne pouvez pas passer d’un cache Premium à un cache Standard ou De base.
     • Vous ne pouvez pas passer d’un cache Standard à un cache De base.
   • Vous pouvez passer d’un cache De base à un cache Standard, mais vous ne pouvez pas modifier la taille en même temps. Si vous avez besoin d'une taille différente, vous pouvez effectuer ultérieurement une opération de mise à l'échelle vers la taille voulue.
   • Vous ne pouvez pas passer directement d’un cache De base à un cache Premium. Vous devez commencer par passer du niveau De base au niveau Standard en une opération de mise à l’échelle, puis du niveau Standard au niveau Premium en une deuxième opération.
   • Vous ne pouvez pas mettre à l’échelle depuis une taille supérieure vers la taille C0 (250 Mo) .

   Lorsqu’un cache est mis à l’échelle vers un nouveau niveau tarifaire, le statut Mise à l’échelle s’affiche avec Azure Cache pour Redis sur la gauche. Une fois la mise à l’échelle terminée, le statut passe de Mise à l’échelle à En cours d’exécution.

3. Vous avez déclenché l’événement, et Event Grid a envoyé le message au point de terminaison configuré lors de l’abonnement. Le message au format JSON contient un tableau répertoriant un ou plusieurs événements. Dans l’exemple suivant, le message JSON contient un tableau avec un événement. Quand vous examinez votre application web, vous pouvez noter qu’un événement ScalingCompleted a été reçu.

   

Nettoyer les ressources

Si vous comptez continuer à utiliser cet événement, ne supprimez pas les ressources créées dans ce guide de démarrage rapide. Sinon, supprimez les ressources que vous avez créées dans ce guide de démarrage rapide.

Sélectionnez le groupe de ressources, puis Supprimer le groupe de ressources.

Étapes suivantes

Maintenant que vous savez créer des rubriques et des abonnements d’événements personnalisés, vous pouvez en apprendre davantage sur Event Grid et ce qu’il peut vous offrir :

• Réaction aux événements Azure Cache pour Redis
• À propos d’Event Grid