Utiliser Azure CLI pour créer un sujet Service Bus et des abonnements à ce sujet

Dans ce guide de démarrage rapide, vous utilisez Azure CLI pour créer une rubrique Service Bus, puis créer des abonnements à cette rubrique.

Qu’est-ce que les rubriques et abonnements Service Bus ?

Les rubriques et abonnements du Service Bus prennent en charge un modèle de communication de messagerie publication/souscription. Lorsque vous utilisez des rubriques et des abonnements, les composants d’une application distribuée ne communiquent pas directement entre eux ; au lieu de cela, ils échangent des messages via une rubrique, qui agit en tant qu’intermédiaire.

Contrairement aux files d’attente Service Bus, dans lesquelles chaque message est traité par un seul consommateur, rubriques et abonnements fournissent une forme de communication un-à-plusieurs, à l’aide d’un modèle de publication/abonnement. Il est possible d’inscrire plusieurs abonnements à une rubrique. Lorsqu’un message est envoyé à une rubrique, il est ensuite mis à la disposition de chaque abonnement pour gérer/traiter indépendamment. Un abonnement à une rubrique ressemble à une file d’attente virtuelle qui reçoit des copies des messages envoyés à la rubrique. Vous pouvez éventuellement inscrire des règles de filtre pour une rubrique par abonnement, ce qui vous permet de filtrer ou de restreindre les messages à une rubrique reçus par les abonnements de rubrique.

Les rubriques et abonnements Service Bus vous permettent de procéder à une mise à l’échelle pour traiter un grand nombre de messages sur un grand nombre d’utilisateurs et d’applications.

Prerequisites

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

Dans ce guide de démarrage rapide, vous utilisez Azure Cloud Shell que vous pouvez lancer après vous être connecté au portail Azure. Pour plus d’informations sur Azure Cloud Shell, consultez Vue d’ensemble d’Azure Cloud Shell. Vous pouvez également installer et utiliser Azure PowerShell sur votre ordinateur.

Créer une rubrique et des abonnements Service Bus

Chaque abonnement à une rubrique peut recevoir une copie de chaque message. Les topics sont entièrement compatibles, tant sur le plan du protocole que de la sémantique, avec les files d’attente Service Bus. Les rubriques Service Bus prennent en charge un large éventail de règles de sélection avec des conditions de filtre, avec des actions facultatives qui définissent ou modifient des propriétés de message. Chaque fois qu’une règle correspond, elle produit un message. Pour en savoir plus sur les règles, les filtres et les actions, suivez ce lien.

1. Connectez-vous au portail Azure.

2. Lancez Azure Cloud Shell en sélectionnant l’icône affichée dans l’image suivante. Basculez en mode Bash si Cloud Shell est en mode PowerShell .

   

3. Exécutez la commande suivante pour créer un groupe de ressources Azure. Mettez à jour le nom du groupe de ressources et l’emplacement si vous le souhaitez.

   az group create --name MyResourceGroup --location eastus
   

4. Exécutez la commande suivante pour créer un espace de noms de messagerie Service Bus. Mettez à jour le nom de l’espace de noms pour qu’il soit unique.

   namespaceName=MyNameSpace$RANDOM
   az servicebus namespace create --resource-group MyResourceGroup --name $namespaceName --location eastus
   

5. Exécutez la commande suivante pour créer une rubrique dans l’espace de noms.

   az servicebus topic create --resource-group MyResourceGroup   --namespace-name $namespaceName --name MyTopic
   

6. Créer le premier abonnement à la rubrique

   az servicebus topic subscription create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name MyTopic --name S1    
   

7. Créer le deuxième abonnement à la rubrique

   az servicebus topic subscription create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name MyTopic --name S2    
   

8. Créer le troisième abonnement à la rubrique

   az servicebus topic subscription create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name MyTopic --name S3    
   

9. Créez un filtre sur le premier abonnement avec un filtre à l’aide de propriétés personnalisées (StoreId est l’un des Store1, Store2et Store3).

   az servicebus topic subscription rule create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name MyTopic --subscription-name S1 --name MyFilter --filter-sql-expression "StoreId IN ('Store1','Store2','Store3')"    
   

10. Créer un filtre sur le deuxième abonnement avec un filtre à l’aide des propriétés du client (StoreId = Store4)

    az servicebus topic subscription rule create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name myTopic --subscription-name S2 --name MySecondFilter --filter-sql-expression "StoreId = 'Store4'"    
    

11. Créez un filtre sur le troisième abonnement avec un filtre à l’aide des propriétés du client (StoreId pas dans Store1, Store2, Store3ou Store4).

    az servicebus topic subscription rule create --resource-group MyResourceGroup --namespace-name $namespaceName --topic-name MyTopic --subscription-name S3 --name MyThirdFilter --filter-sql-expression "StoreId NOT IN ('Store1','Store2','Store3', 'Store4')"     
    

12. Exécutez la commande suivante pour obtenir la chaîne de connexion principale de l’espace de noms. Vous utilisez cette chaîne de connexion pour vous connecter à la file d’attente et envoyer et recevoir des messages.

    az servicebus namespace authorization-rule keys list --resource-group MyResourceGroup --namespace-name $namespaceName --name RootManageSharedAccessKey --query primaryConnectionString --output tsv    
    

    Notez la chaîne de connexion et le nom de la rubrique. Vous les utilisez pour envoyer et recevoir des messages.

Étapes suivantes

Pour savoir comment envoyer des messages à une rubrique et recevoir ces messages via un abonnement, consultez l’article suivant : sélectionnez le langage de programmation dans la table des matières.