Azure Web PubSub 이벤트 처리기를 로컬로 문제 해결 및 디버그하는 방법
WebSocket 연결이 Web PubSub 서비스에 연결되면 서비스는 등록된 업스트림에 HTTP POST 요청을 작성하며 HTTP 응답을 예상합니다. 업스트림을 이벤트 처리기 호출하고 이벤트 처리기는 Web PubSub CloudEvents 사양에 따라 들어오는 이벤트를 처리해야 합니다.
이벤트 처리기가 로컬로 실행되면 로컬 서버에 공개적으로 액세스할 수 없습니다.
트래픽을 localhost로 라우팅하는 방법은 두 가지가 있습니다. 하나는 ngrok, localtunnel 또는 TunnelRelay와 같은 도구를 사용하여 인터넷에서 액세스할 수 있도록 localhost를 노출하는 것입니다. 또 다른 방법이자 권장되는 방법은 awps-tunnel을 사용하여 도구를 통해 Web PubSub 서비스에서 로컬 서버로 트래픽을 터널링하는 것입니다.
Web PubSub 로컬 터널 도구는 내부적으로 Web PubSub 서비스에 대한 여러 영구 터널 연결(서버 연결의 한 유형으로 간주됨)을 설정합니다. 이벤트가 발생할 때마다 Web PubSub 서비스는 터널 연결을 통해 로컬 터널 도구로 이벤트 메시지를 라우팅하고 로컬 터널 도구는 HTTP 요청을 재구성하여 업스트림 서버로 보냅니다.
로컬 터널 도구는 웹 보기 페이지를 통해 워크플로를 생생하게 볼 수 있습니다. 기본적으로 웹 보기는 로컬 포트 upstream port + 1000에서 수신 대기하며 명령 매개 변수 --webviewPort <your-custom-port>를 사용하여 웹 보기 포트를 사용자 지정할 수 있습니다.
웹 보기에는 다음 네 개의 탭이 있습니다.
- 클라이언트 탭. 이 탭은 Web PubSub를 연결하고 데이터를 보내는 테스트 WebSocket 클라이언트를 제공합니다.
- Web PubSub 탭. 이 탭은 Web PubSub 서비스에 대한 기본 정보를 제공하고 사용되는 경우 라이브 추적 페이지를 포함합니다.
- 로컬 터널 탭. 이 탭에는 로컬 터널 도구를 통해 로컬 서버로 가는 모든 요청이 나열됩니다.
- 서버 탭. 이 탭에는 로컬 서버에 대한 기본 정보가 표시됩니다. 또한 아래에 표시된 샘플 코드와 유사한 코드가 포함된 기본 제공 에코 서버도 제공합니다.
로컬 터널 도구를 사용하여 개발에 따라 터널 도구를 로컬로 설치하고 실행하여 이벤트 처리기 서버를 로컬에서 개발합니다.
다음 단계
다음 리소스를 사용하여 사용자 고유의 애플리케이션 빌드를 시작합니다.