Lire en anglais

Partager via


Démarrage rapide : Utiliser Azure Event Grid pour acheminer des événements de stockage d’objet blob vers le point de terminaison web (Portail Azure)

Event Grid est un service entièrement géré qui vous permet de facilement gérer des événements dans de nombreux services et applications Azure. Il simplifie la création d’applications pilotées par les événements et serverless. Pour une présentation du service, consultez Vue d’ensemble d’Event Grid.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Une fois que vous avez terminé, vous voyez que les données d’événement sont envoyées à l’application web.

Capture d’écran montrant l’exemple d’application Visionneuse Azure Event Grid avec un événement.

Créez un compte de stockage.

  1. Connectez-vous au portail Azure.

  2. Pour créer un stockage d’objets blob, sélectionnez Créer une ressource.

  3. Dans Rechercher, entrez Compte de stockage, puis sélectionnez Compte de stockage dans la liste des résultats.

    Capture d’écran montrant la recherche d’un compte de stockage sur la page Créer une ressource.

  4. Dans la page Compte de stockage, sélectionnez Créer pour commencer à créer le compte de stockage. Pour s’abonner à des événements, créez un compte de stockage v2 à usage général ou un compte de stockage d’objets blob.

  5. Dans la page Créer un compte de stockage, procédez comme suit :

    1. Sélectionnez votre abonnement Azure.

    2. Dans le champ Groupe de ressources, créez un groupe de ressources Azure ou sélectionnez un groupe existant.

    3. Entrez le nom de votre compte de stockage.

    4. Sélectionnez la Région dans laquelle vous souhaitez créer le compte de stockage.

    5. Pour Service principal, sélectionnez Stockage Blob Azure ou Azure Data Lake Storage Gen 2.

    6. Pour Redondance, sélectionnez Stockage localement redondant (LRS) dans la liste déroulante.

    7. Au bas de la page, sélectionnez Examiner et créer.

      Capture d’écran montrant la page Créer un compte de stockage.

    8. Sous l’onglet Vérifier + créer, passez en revue les paramètres, puis sélectionnez Créer.

      Notes

      Seuls les comptes de stockage de type StorageV2 (v2 universel) et BlobStorage prennent en charge l’intégration d’événements. Le type Stockage (v1 universel) ne prend pas en charge l’intégration à Event Grid.

  6. Le déploiement prend quelques minutes. Dans la page Déploiement, sélectionnez Accéder à la ressource.

    Capture d’écran montrant la page déploiement réussi avec un lien pour accéder à la ressource.

  7. Dans la page Compte de stockage, sélectionnez Événements dans le menu de gauche.

    Capture d’écran montrant la page Événements d’un compte de stockage Azure.

  8. Conservez cette page dans le navigateur web ouverte.

Créer un point de terminaison de message

Avant de nous abonner aux événements du stockage d’objets blob, nous allons créer le point de terminaison pour le message de l’é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 pour déployer la solution sur votre abonnement.

    Bouton pour déployer le modèle Resource Manager sur Azure.

  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éé lors de la création du compte de stockage. 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. Sélectionnez Revoir + créer.

      Capture d’écran montrant la page Déploiement personnalisé.

  3. Dans la page Vérifier + créer, sélectionnez Créer.

  4. Le déploiement prend quelques minutes. Dans la page Déploiement, sélectionnez Accéder à la ressource.

    Capture d’écran montrant la page déploiement réussi avec un lien pour accéder au groupe de ressources.

  5. Dans la page Groupe de ressources, dans la liste des ressources, sélectionnez l’application web que vous avez créée. Vous pouvez également voir le plan App Service et le compte de stockage dans cette liste.

    Capture d’écran montrant la sélection d’une application web dans le groupe de ressources.

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

    Capture d’écran montrant la sélection du lien pour accéder à l’application web.

  7. Vérifiez que vous voyez le site, mais qu’aucun événement n’est encore publié.

    Voir le nouveau site.

    Important

    Gardez la fenêtre Azure Event Grid Viewer ouverte pour pouvoir voir les événements au fur et à mesure qu’ils sont publiés.

S’abonner à un stockage d’objets blob

Vous vous abonnez à une rubrique pour communiquer à Event Grid les événements qui vous intéressent, et où les envoyer.

  1. Si vous avez fermé la page Compte de stockage, accédez à votre compte de stockage Azure que vous avez créé précédemment. Dans le menu de gauche, sélectionnez Toutes les ressources et votre compte de stockage.

  2. Dans la page Compte de stockage, sélectionnez Événements dans le menu de gauche.

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

    Capture d’écran montrant la sélection d’un webhook sur la page Événements.

  4. Dans la page Créer un abonnement aux événements, effectuez les étapes suivantes :

    1. Entrez un nom pour l’abonnement aux événements.

    2. Entrez un nom pour la rubrique système. Pour en savoir plus sur les rubriques système, consultez Vue d’ensemble des rubriques système.

    3. Confirmez que Type de point de terminaison est défini sur Webhook.

      Capture d’écran montrant la page Créer un abonnement aux événements avec un nom pour la rubrique système.

  5. Pour Point de terminaison, sélectionnez Configurer un point de terminaison, entrez l’URL de votre application web et ajoutez api/updates à l’URL de la page d’accueil (par exemple, https://spegridsite.azurewebsites.net/api/updates), puis sélectionnez Confirmer la sélection.

    Capture d’écran montrant la sélection de la page Sélectionner un webhook.

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

    Capture d’écran montrant la sélection de la page Créer un abonnement aux événements avec tous les champs sélectionnés.

  7. Affichez à nouveau votre application web, et notez qu’un événement de validation d’abonnement lui est 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.

    Capture d’écran montrant la visionneuse Event Grid avec l’événement de validation de l’abonnement.

Nous allons maintenant déclencher un événement pour voir comment Event Grid distribue le message à votre point de terminaison.

Envoyer un événement à votre point de terminaison

Pour déclencher un événement pour le stockage d’objets blob, chargez un fichier. Celui-ci n’a pas besoin d’un contenu spécifique.

  1. Dans le portail Azure, accédez à votre compte de stockage d’objets blob, puis sélectionnez Conteneurs dans le menu de gauche.

  2. Sélectionnez + Conteneur. Donnez un nom à votre conteneur et utilisez n’importe quel niveau d’accès, puis sélectionnez Créer.

    Capture d’écran de la page Nouveau conteneur.

  3. Sélectionnez votre nouveau conteneur.

    Capture d’écran montrant la sélection du conteneur.

  4. Pour charger un fichier, sélectionnez Charger. Dans la page Charger l’objet blob, recherchez et sélectionnez un fichier à charger à des fins de test, puis sélectionnez Charger dans cette page.

    Capture d’écran montrant la page Charger un objet blob pour charger un exemple d’image.

  5. Accédez à votre fichier de test et chargez-le.

  6. 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 remarquerez qu’un événement créé par un objet blob a été reçu.

    Capture d’écran montrant la page Afficheur Event Grid avec l’événement créé par un objet blob.

Nettoyer les ressources

Si vous envisagez de continuer à utiliser cet événement, ne supprimez pas les ressources créées dans cet article. Dans le cas contraire, supprimez les ressources créées avec cet article.

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

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 :