Solución de problemas y depuración local del controlador de eventos Azure Web PubSub

Cuando una conexión WebSocket se conecta al servicio Web PubSub, el servicio formula una solicitud HTTP POST al canal ascendente registrado y espera una respuesta HTTP. Llamamos al canal ascendente como controlador de eventos y el controlador de eventos es responsable de controlar los eventos entrantes siguiendo la especificación de CloudEvents de Web PubSub.

Cuando el controlador de eventos se ejecuta localmente, el servidor local no es accesible públicamente.

Hay dos maneras de enrutar el tráfico a su localhost, uno consiste en exponer localhost para que sea accesible en Internet mediante herramientas como ngrok, localtunnel o TunnelRelay. Otra manera, y también la manera recomendada es usar awps-tunnel para tunelizar el tráfico desde el servicio Web PubSub a través de la herramienta al servidor local.

La herramienta de túnel local de Web PubSub, en segundo plano, establece varias conexiones de túnel persistentes (lo consideramos como un tipo de conexiones de servidor) al servicio Web PubSub. Cada vez que se produzca un evento, el servicio Web PubSub enruta el mensaje de evento a través de la conexión de túnel a la herramienta de túnel local y la herramienta túnel local reforma la solicitud HTTP y envía la solicitud al servidor ascendente.

La herramienta de túnel local proporciona una vista vívida del flujo de trabajo a través de una página de vista web. La vista web escucha de forma predeterminada en el puerto upstream port + 1000local y puede personalizar el puerto de vista web mediante el parámetro --webviewPort <your-custom-port>de comando .

La vista web contiene cuatro pestañas:

  • La pestaña Cliente proporciona un cliente webSocket de prueba para conectar Web PubSub y enviar datos.
  • La pestaña Web PubSub proporciona la información básica sobre el servicio Web PubSub e inserta la página Seguimiento en directo si está habilitada.
  • La pestaña Túnel local muestra todas las solicitudes que pasan por la herramienta de túnel local al servidor local.
  • La pestaña Servidor muestra la información básica sobre el servidor local. También proporciona un servidor de eco integrado con código similar al código de ejemplo que se muestra a continuación.

Screenshot of showing the traffic inspection.

Siga Desarrollo con la herramienta de túnel local para instalar y ejecutar la herramienta de túnel localmente para desarrollar el servidor del controlador de eventos localmente.

Pasos siguientes

Use estos recursos para empezar a compilar su propia aplicación: