Vue d’ensemble de l’émulateur Azure Service Bus
L’émulateur Azure Service Bus offre une expérience de développement locale pour le service Service Bus. Vous pouvez utiliser l’émulateur pour développer et tester du code sur le service en isolation, sans interférences cloud.
Avantages
Les principaux avantages de l’utilisation de l’émulateur sont les suivants :
- Développement local : l’émulateur offre une expérience de développement local, vous permettant de travailler hors connexion et d’éviter une latence du réseau.
- Rentabilité : avec l’émulateur, vous pouvez tester vos applications sans entraîner de coûts d’utilisation du cloud.
- Environnement de test isolé : vous pouvez tester votre code de manière isolée, pour vous assurer que d’autres activités n’affectent pas les tests.
- Boucle de développement interne optimisée : utilisez l’émulateur pour prototyper et tester rapidement vos applications avant de les déployer dans le cloud.
Remarque
L’émulateur Service Bus est disponible sous Termes du contrat de licence logiciel Microsoft.
L’émulateur Service Bus n’est pas compatible avec le Service Bus Explorer open source détenu par la communauté.
Fonctionnalités
L’émulateur fournit ces fonctionnalités :
- Déploiement conteneurisé : il s’exécute en tant que conteneur Docker (basé sur Linux).
- Compatibilité multiplateforme : vous pouvez l’utiliser sur n’importe quelle plateforme, y compris Windows, macOS et Linux.
- Configuration : vous pouvez gérer le nombre d’entités Service bus à l’aide de la configuration fournie par JSON.
- Prise en charge de la diffusion en continu : il prend en charge la diffusion en continu de messages à l’aide d’AMQP (Advanced Message Queuing Protocol).
- Observabilité : il fournit des fonctionnalités d’observabilité, notamment la journalisation sur console et fichier.
Limitations connues
La version actuelle de l’émulateur présente les limitations suivantes :
- Il ne peut pas diffuser en continu des messages à l’aide du protocole JMS.
- Les entités partitionnée ne sont pas compatibles avec l’émulateur.
- Il ne prend pas en charge les opérations de gestion immédiate avec un SDK côté client.
Remarque
Après le redémarrage d’un conteneur, les données et les entités ne sont pas conservées dans l’émulateur.
Différences par rapport au service cloud
L’émulateur Service bus étant destiné uniquement au développement et aux tests, il existe des différences fonctionnelles entre l’émulateur et le service cloud.
L’émulateur ne prend pas en charge ces fonctionnalités générales :
- Fonctionnalités Azure telles que l’intégration de réseau virtuel, l’intégration Microsoft Entra ID, les journaux d’activité et un portail d’interface utilisateur
- Fonctionnalités de mise à l’échelle automatique
- Géo-reprise d'activité après sinistre
- Prise en charge des messages volumineux
- Métriques visuelles et alertes
Remarque
L’émulateur est destiné uniquement aux scénarios de développement et de test. Nous déconseillons tout type d’utilisation de production. Nous ne fournissons aucune prise en charge officielle de l’émulateur.
Signalez les problèmes ou suggestions dans le référentiel d’installation GitHub de l’émulateur.
Quotas d'utilisation
Comme le service cloud Service bus, l’émulateur fournit les quotas suivants pour l’utilisation :
| Propriété | Valeur maximale | Configurable par l’utilisateur dans certaines limites |
|---|---|---|
| Nombre d’espaces de noms pris en charge | 1 | Non |
| Nombre d’entités (files d’attente/rubriques) dans un espace de noms | 50 | Oui |
| Nombre d’abonnements par rubrique | 50 | Oui |
| Nombre de filtres de corrélation par rubrique | 1 000 | Oui |
| Nombre de connexions simultanées à un espace de noms | 10 | Oui |
| Nombre de requêtes de réception simultanées sur une entité (file d’attente/rubrique) ou un abonnement | 200 | Oui |
| Taille des messages | 256 KB | Non |
| Taille de la file d’attente ou de la rubrique | 100 Mo | Non |
| Durée de vie du message | 1hr | Oui |
Modifications de configuration de quotas
Par défaut, l’émulateur s’exécute avec le fichier de configuration config.json. Vous pouvez configurer les quotas associés à Service bus en modifiant ce fichier de la manière suivante, en fonction de vos besoins :
- Entités : vous pouvez ajouter d’autres entités Service Bus conformément aux quotas pris en charge.
- Enregistrement : l’émulateur prend en charge la journalisation sur une console, dans un fichier ou les deux. Vous pouvez choisir selon vos préférences personnelles.
Important
Vous devez fournir les modifications apportées à la configuration JSON avant d’exécuter l’émulateur. Les modifications ne sont pas respectées immédiatement. Pour que les modifications prennent effet, vous devez redémarrer le conteneur.
Vous ne pouvez pas renommer l’espace de noms prédéfini (name) dans le fichier de configuration.
Journaux d’activité pour le débogage
Pendant les tests, les journaux de console ou de fichiers vous aident à déboguer des échecs inattendus. Pour vérifier les journaux :
- Journaux de console : dans l’interface utilisateur du bureau Docker, sélectionnez le nom du conteneur.
- Journaux de fichiers : dans le conteneur, accédez à /home/app/EmulatorLogs.