Comment dépanner et déboguer le gestionnaire d’événements Azure Web PubSub localement
Lorsqu’une connexion WebSocket se connecte au service Web PubSub, le service formule une requête HTTP POST en amont et attend une réponse HTTP. Nous appelons l’amont Gestionnaire d’événements, et le Gestionnaire d’événements est chargé de gérer les événements entrants en suivant la spécification Web PubSub CloudEvents.
Lorsque le gestionnaire d’événements s’exécute localement, le serveur local n’est pas accessible publiquement.
Il existe deux façons d’acheminer le trafic vers votre localhost, il s’agit d’exposer localhost à être accessible sur Internet à l’aide d’outils tels que ngrok, localtunnel ou TunnelRelay. Une autre façon, et également la méthode recommandée consiste à utiliser awps-tunnel pour tunneliser le trafic à partir du service Web PubSub via l’outil vers votre serveur local.
L’outil de tunnel local Web PubSub, sous le capot, établit plusieurs connexions de tunnel persistantes (nous la considérons comme un type de connexions serveur) au service Web PubSub. Chaque fois qu’un événement arrive, le service Web PubSub route le message d’événement via la connexion de tunnel à l’outil de tunnel local, et l’outil de tunnel local reforme la requête HTTP et envoie la requête à votre serveur amont.
L’outil de tunnel local fournit une vue vive du flux de travail via une page de vue web. La vue web par défaut écoute sur le port upstream port + 1000local et vous pouvez personnaliser le port webview à l’aide du paramètre --webviewPort <your-custom-port>de commande.
La vue web contient quatre onglets :
- L’onglet client fournit un client WebSocket de test pour connecter Web PubSub et envoyer des données.
- L’onglet Web PubSub fournit les informations de base sur votre service Web PubSub et incorpore la page Live Trace si elle est activée.
- L’onglet Tunnel local répertorie toutes les requêtes qui transitent par l’outil de tunnel local vers votre serveur local.
- L’onglet Serveur affiche les informations de base sur votre serveur local. Il fournit également un serveur d’écho intégré avec du code similaire à l’exemple de code présenté ci-dessous.
Suivez Développer avec l’outil de tunnel local pour installer et exécuter l’outil tunnel localement pour développer votre serveur de gestionnaires d’événements localement.
Étapes suivantes
Utilisez ces ressources pour commencer à créer votre propre application :