Démarrage rapide : Router 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 n’avez pas d’abonnement Azure, créez un compte gratuit Azure 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. Pour créer un cache, connectez-vous au portail Azure. Dans le menu du portail, sélectionnez Créer une ressource.

   

2. Dans le volet Démarrer, entrez Azure Cache pour Redis dans la barre de recherche. Dans les résultats de la recherche, localisez Azure Cache pour Redis, puis sélectionnez Créer.

   

3. Dans le volet Nouveau cache Redis, sous l’onglet Informations de base, configurez les paramètres suivants pour votre cache :

   Setting	Action	Description
   Abonnement	Sélectionnez votre abonnement Azure.	L’abonnement à utiliser pour créer l’instance d’Azure Cache pour Redis.
   Groupe de ressources	Sélectionnez un groupe de ressources ou choisissez Créer nouveau, puis entrez un nouveau nom de groupe de ressources.	Le nom du groupe de ressources dans lequel créer votre cache et d’autres 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 DNS	Entrez un nom unique.	Le nom du cache doit être une chaîne de 1 à 63 caractères ne contenant que des chiffres, des lettres et des traits d’union. Le nom doit commencer et se terminer par un chiffre ou une lettre, et ne doit pas contenir de traits d’union consécutifs. Le nom d’hôte de votre instance de cache est \<DNS name>.redis.cache.windows.net.
   Emplacement	Sélectionnez un emplacement.	Une région Azure proche d’autres services qui utilisent votre cache.
   Référence SKU du cache	Sélectionnez une référence SKU.	La référence SKU détermine les paramètres de taille, de performance et de fonctionnalités disponibles pour le cache. Pour plus d’informations, consultez Présentation d’Azure Cache pour Redis.
   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.

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

7. Dans le volet Avancé, vérifiez ou sélectionnez une méthode d’authentification en fonction des informations suivantes :

   

   • Par défaut, pour un nouveau cache Basic, Standard ou Premium, l’authentification Microsoft Entra est activée et l’authentification par clés d’accès est désactivée.
   • Pour les caches Basic ou Standard, vous pouvez choisir la sélection d'un port non TLS.
   • Pour les caches Standard et Premium, vous pouvez choisir d'activer les zones de disponibilité. Vous ne pouvez pas désactiver les zones de disponibilité une fois le cache créé.
   • Pour un cache Premium, configurez les paramètres afin d’utiliser un port non-TLS, le clustering, l’identité managée et la persistance des données.

   Important

   Pour bénéficier d’une sécurité optimale, nous vous recommandons d’utiliser si possible Microsoft Entra ID avec des identités managées pour autoriser les requêtes sur votre cache. L’autorisation avec Microsoft Entra ID et les identités managées offre davantage de sécurité et de facilité d’utilisation que l’autorisation par clé d’accès partagée. 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. (Facultatif) Sélectionnez l’onglet Étiquettes ou sélectionnez Suivant : Étiquettes.

9. (Facultatif) Sous l’onglet Étiquettes, entrez un nom et une valeur d’étiquette si vous voulez catégoriser votre ressource de cache.

10. Sélectionnez le bouton Vérifier + Créer.

    Sous l’onglet Vérifier et créer, Azure vérifie automatiquement votre configuration.

11. Une fois que le message vert Validation réussie s’affiche, sélectionnez Créer.

Le déploiement d’un nouveau cache prend plusieurs minutes. Vous pouvez surveiller la progression du déploiement dans le volet Vue d’ensemble d’Azure Cache pour Redis. Lorsque État indique 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.

   Paramètre	Valeur suggérée	Description
   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 et 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 :

   Paramètre	Valeur suggérée	Description
   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