Partager via

Distribuer des événements à Azure Event Hubs en utilisant des rubriques d’espace de noms – Portail Azure

  • Article

L'article fournit des instructions détaillées pour publier des événements sur Azure Event Grid au format CloudEvents JSON et livrer ces événements à l'aide du modèle de livraison par envoi (push).

Pour être plus précis, vous utilisez le portail Azure et Curl pour publier des événements sur une rubrique d’espaces de noms dans Event Grid et pousser ces événements d’un abonnement aux événements vers une destination de gestionnaire Event Hubs. Pour plus d'informations sur le modèle de livraison par envoi (push), consultez Vue d'ensemble de la livraison par envoi (push).

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

Créer un espace de noms Event Grid

Un espace de noms Event Grid fournit un point de terminaison défini par l’utilisateur sur lequel vous publiez vos événements. L’exemple suivant crée un espace de noms dans votre groupe de ressources à l’aide de Bash dans Azure Cloud Shell. Le nom de l’espace de noms doit être unique, car il fait partie d’une entrée DNS.

  1. Accédez au portail Azure.

  2. Dans la barre de recherche de la rubrique, tapez Event Grid Namespaces, puis sélectionnez Event Grid Namespaces dans les résultats.

    Capture d’écran montrant la barre de recherche dans le Portail Azure.

  3. Dans la page Espaces de noms Event Grid, sélectionnez + Créer dans la barre de commandes. Capture d’écran montrant la page Espaces de noms Event Grid avec le bouton Créer (dans la barre de commandes) sélectionné.

  4. Dans la page Créer un espace de noms, suivez ces étapes :

    1. Sélectionnez l’abonnement Azure dans lequel vous souhaitez créer l’espace de noms.
    2. Créer un groupe de ressources en sélectionnant Créer ou sélectionnez un groupe de ressources existant.
    3. Entrez un nom pour l’espace de noms.
    4. Sélectionnez la localisation où vous voulez créer le groupe de ressources.
    5. Sélectionnez ensuite Vérifier + créer.
      Capture d’écran montrant la page Créer un espace de noms.
    6. Dans la page Vérifier + créer, sélectionnez Créer.

  5. Dans la page Déploiement, sélectionnez Accéder à la ressource une fois le déploiement réussi.

Obtenir la clé d’accès

  1. Dans la page Espace de noms Event Grid, sélectionnez Clé d’accès dans le menu de gauche.
  2. Sélectionnez le bouton de copie à côté de la clé d’accès. Capture d’écran montrant la page Espace de noms Event Grid avec l’onglet Clé d’accès sélectionné.
  3. Enregistrez la clé d’accès à l’emplacement de votre choix. Vous l’utiliserez plus loin dans ce démarrage rapide.

Activer l’identité managée de l’espace de noms Event Grid

Pour activer une identité managée affectée par le système dans l’espace de noms Event Grid. Pour remettre des événements à Event Hubs dans votre espace de noms Event Hubs à l’aide d’une identité managée, procédez comme suit :

  1. Activez l’identité managée affectée par le système ou affectée par l’utilisateur : espaces de noms. Passez à la section suivante pour savoir comment activer l’identité managée en utilisant Azure CLI.
  2. Ajouter l’identité au rôle Expéditeur de données Azure Event Hubs sur l’espace de noms Event Hubs. Passez à la section suivante pour découvrir comment ajouter l’attribution de rôle.
  3. Configurez l’abonnement aux événements qui utilise un hub d’événements comme point de terminaison pour utiliser l’identité managée affectée par le système ou par l’utilisateur.

Dans cette section, vous activez une identité managée affectée par le système sur l’espace de noms. Vous effectuez les autres étapes plus loin dans ce guide de démarrage rapide.

  1. Dans la page Espace de noms Event Grid, sélectionnez Identité dans le menu de gauche.

  2. Dans la page Identité, sélectionnez Activé pour État.

  3. Sélectionnez Enregistrer sur la barre de commandes.

    Capture d’écran montrant l’onglet Identité dans la page Espaces de noms Event Grid.

Créer une rubrique dans l’espace de noms

Créez une rubrique utilisée pour contenir tous les événements publiés sur le point de terminaison de l'espace de noms.

  1. Sélectionnez Rubriques dans le menu de gauche.
  2. Dans la page Rubriques, sélectionnez + Rubrique dans la barre de commandes. Capture d’écran montrant la page Rubriques.
  3. Dans la page Créer une rubrique, procédez comme suit :
    1. Entrez un nom pour la rubrique.
    2. Sélectionnez Créer.
      Capture d’écran montrant la page Créer une rubrique.

Créer un espace de noms Event Hubs

Créez une ressource Event Hubs utilisée comme destination du gestionnaire pour l’abonnement à la livraison push de la rubrique d’espace de noms. Effectuez ces étapes dans un onglet distinct de votre navigateur Internet ou dans une fenêtre distincte. Accédez au portail Azure et connectez-vous avec les mêmes informations d’identification que celles que vous avez utilisées précédemment et le même abonnement Azure.

  1. Tapez Event Hubs dans la barre de recherche, puis sélectionnez Event Hubs.
  2. Dans la page Event Hubs, sélectionnez + Créer dans la barre de commandes.
  3. Dans la page Créer un espace de noms, suivez ces étapes :
    1. Sélectionnez l’Abonnement Azure que vous avez utilisé pour créer l’espace de noms Event Grid.
    2. Sélectionnez le groupe de ressources utilisé précédemment.
    3. Entrez un nom pour l’espace de noms Event Hubs.
    4. Sélectionnez la même localisation que celle que vous avez utilisée pour l’espace de noms Event Grid.
    5. Sélectionnez De base pour le niveau tarifaire.
    6. Sélectionnez Revoir + créer. Capture d’écran montrant la page Créer un espace de noms Event Hub.
    7. Dans la page Vérifier, sélectionnez Créer.
  4. Dans la page Déploiement, sélectionnez Accéder à la ressource une fois le déploiement réussi.

Ajouter une identité managée Event Grid au rôle Expéditeur de données Event Hubs

  1. Sur la page Espace de noms Event Hubs, sélectionnez Contrôle d’accès (IAM) dans le menu de gauche.
  2. Sélectionnez Ajouter ->Ajouter une attribution de rôle dans la barre de commandes. Capture d’écran montrant la page Espace de noms Event Hubs avec l’onglet Contrôle d’accès sélectionné.
  3. Dans la page Ajouter une attribution de rôle, recherchez Expéditeur de données Event Hubs et sélectionnez Expéditeur de données Azure Event Hubs dans la liste des rôles, puis sélectionnez Suivant. Capture d’écran montrant la page Ajouter une attribution de rôle.
  4. Sous l’onglet Membres, sélectionnez Identité managée pour le type, puis sélectionnez + Sélectionner des membres. Capture d’écran montrant l’onglet des membres dans la page Ajouter une attribution de rôle.
  5. Dans la page Sélectionner des identités managées, sélectionnez Espace de noms Event Grid pour l’Identité managée, puis sélectionnez l’identité managée qui a le même nom que l’espace de noms Event Grid. Capture d’écran montrant la page Sélection d’identités managées.
  6. Dans la page Sélectionner des identités managées, choisissez Sélectionner. Capture d’écran montrant l’identité managée sélectionnée.
  7. Ensuite, dans la page Ajouter une attribution de rôle, sélectionnez Vérifier + attribuer. Capture d’écran montrant la page Ajouter une attribution de rôle avec l’onglet Identité managée sélectionné.
  8. Sur la page Vérifier + attribuer, sélectionnez Vérifier + attribuer.

Créer un hub d’événements

  1. Dans la page Espace de noms Event Hubs, sélectionnez Event Hubs dans le menu de gauche.
  2. Dans la page Event Hubs, sélectionnez + Hub d’événements dans la barre de commandes. Capture d’écran montrant la page Event Hubs avec + Event Hub sélectionné.
  3. Dans la page Créer un hub d’événements, entrez un nom pour le hub d’événements, puis sélectionnez Vérifier + créer. Capture d’écran montrant la page Créer un hub d’événements.
  4. Dans la page Vérifier + créer, sélectionnez Créer.

Créer un abonnement d’événement

Créez un abonnement aux événements en définissant son mode de livraison sur Push, qui prend en charge la livraison push.

  1. Basculez vers l’onglet ou la fenêtre qui a l’espace de noms Event Grid ouvert à partir de l’onglet ou de la fenêtre qui a la page Espace de noms Event Hubs ouverte.
  2. Dans la page Espace de noms Event Grid, sélectionnez Rubriques dans le menu de gauche.
  3. Dans la page Rubriques, sélectionnez la rubrique que vous avez créée à l’étape précédente.
  4. Sélectionnez + Abonnement dans la barre de commandes. Capture d’écran montrant la page Rubrique avec le bouton Créer un abonnement sélectionné.
  5. Dans la page Créer un abonnement aux événements, effectuez les étapes suivantes :
    1. Sous l’onglet De base, entrez un nom pour l’abonnement aux événements.
    2. Sélectionnez Push pour le mode de livraison des événements.
    3. Vérifiez que Hub d’événements est sélectionné pour le Type de point de terminaison.
    4. Sélectionnez Configurer un point de terminaison. Capture d’écran montrant la page Créer un abonnement avec l’option Envoyer sélectionnée pour le mode de livraison.
    5. Dans la page Sélectionner un hub d’événements, suivez ces étapes :
      1. Sélectionnez l’Abonnement Azure et le groupe de ressources qui contient le hub d’événements.
      2. Sélectionnez Espace de noms Event Hubs et le hub d’événements.
      3. Sélectionnez ensuite Confirmer la sélection. Capture d’écran montrant le volet Sélectionner un Event Hub.
    6. De retour dans la page Créer un abonnement, sélectionnez Affectée par le système pour Type d’identité managée. Capture d’écran montrant la page Créer un abonnement, avec Affectée par le système défini pour le type Identité managée.
    7. Sélectionnez Créer.

Envoyer des événements à la rubrique

Maintenant, envoyez un exemple d'événement au sujet de l'espace de noms en suivant les étapes de cette section.

  1. Lancez Cloud Shell dans le portail Azure. Basculez vers Bash.

    Capture d’écran montrant le Cloud Shell.

  2. Dans Cloud Shell, exécutez la commande suivante pour déclarer une variable destinée à contenir la clé d’accès de l’espace de noms. Vous avez noté la clé d’accès précédemment dans ce démarrage rapide.

    key=ACCESSKEY

  3. Déclarez une variable pour contenir l’URI de l’opération de publication. Remplacez NAMESPACENAME par le nom de votre espace de noms Event Grid et TOPICNAME par le nom de la rubrique.

    publish_operation_uri=https://NAMESPACENAME.eastus-1.eventgrid.azure.net/topics/TOPICNAME:publish?api-version=2023-06-01-preview

  4. Créez un exemple d'événement conforme à CloudEvents :

    event=' { "specversion": "1.0", "id": "'"$RANDOM"'", "type": "com.yourcompany.order.ordercreatedV2", "source" : "/mycontext", "subject": "orders/O-234595", "time": "'`date +%Y-%m-%dT%H:%M:%SZ`'", "datacontenttype" : "application/json", "data":{ "orderId": "O-234595", "url": "https://yourcompany.com/orders/o-234595"}} '

    L’élément data est la charge utile de votre événement. N’importe quel fichier JSON bien construit peut être placé dans ce champ. Consultez les spécifications CloudEvents pour plus d’informations sur les propriétés (également appelées attributs de contexte) qui peuvent être activées dans un événement.

  5. Utilisez CURL pour envoyer l'événement au sujet. CURL est un utilitaire qui envoie des requêtes HTTP.

    curl -X POST -H "Content-Type: application/cloudevents+json" -H "Authorization:SharedAccessKey $key" -d "$event" $publish_operation_uri

    Accédez à la page Espace de noms Event Hubs dans le portail Azure, actualisez la page et vérifiez que le compteur de messages entrants dans le graphique indique qu’un événement a été reçu.

    Capture d’écran montrant la page Event Hub avec un graphique affichant la réception d’un événement.

Étapes suivantes

Dans cet article, vous avez créé et configuré l’espace de noms Event Grid et les ressources Event Hubs. Pour obtenir des instructions détaillées sur la réception d’événements à partir d’un hub d’événements, consultez les tutoriels suivants :