diff --git a/locale/ko/docs/guides/debugging-getting-started.md b/locale/ko/docs/guides/debugging-getting-started.md index 814568f3bd27a..36ce8eae8b63d 100644 --- a/locale/ko/docs/guides/debugging-getting-started.md +++ b/locale/ko/docs/guides/debugging-getting-started.md @@ -32,19 +32,18 @@ activate the Inspector API. ## 인스펙터 활성화 -**--inspect** 스위치로 시작하면 Node.js 프로세스가 [Inspector 프로토콜][]에서 정의된 -진단 명령어를 웹소켓으로 받습니다. [Inspector 프로토콜][]은 기본적으로 127.0.0.1:9229를 -사용합니다. 각 프로세스에는 고유한 [UUID][](예: `0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e`)도 -할당됩니다. +`--inspect` 스위치로 시작하면 Node.js 프로세스가 디버깅 클라이언트에서 수신을 +시작하고 기본 호스트와 포트로 `127.0.0.1:9229`를 사용합니다. 각 프로세스는 +고유한 [UUID][]도 할당받습니다. -인스펙터 클라이언트가 웹소켓 인터페이스로 접속하기 위해 호스트 주소, 포트, UUID를 알고 지정해야 합니다. -전체 URL은 `ws://127.0.0.1:9229/0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e`와 같고 당연히 -인스턴스의 실제 호스트와 포트, UUID에 따라 달라집니다. +인스펙터 클라이언트는 호스트 주소, 포트, UUID를 알아야 접속할 수 있습니다. 전체 +URL은 `ws://127.0.0.1:9229/0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e` 같은 형태가 +됩니다. -인스펙터도 디버깅 대상에 대한 메타데이터를 제공하는 HTTP 엔드포인트를 가집니다. 이 메타데이터에는 -웹소켓 URL, UUID, 크롬 개발자도구 URL이 포함됩니다. `http://[host:port]/json/list`에 -HTTP 요청을 보내서 이 메타데이터를 받을 수 있습니다. 이는 다음과 같은 JSON 객체를 반환합니다. -인스펙터에 직접 접속하려면 URL로 `webSocketDebuggerUrl` 프로퍼티를 사용하세요. +Node.js가 `SIGUSR1` 신호를 받으면 디버깅 메시지도 수신하기 +시작합니다.(`SIGUSR1`은 Windows에서는 사용할 수 없습니다.) Node.js 7 이하 +버전에서는 레거시 Debugger API가 활성화되고 Node.js 8 이상에서는 Inspector API를 +활성화합니다. --- @@ -196,6 +199,11 @@ Node 인스펙터에 접속할 수 있는 여러 상용 도구와 오픈소스 * 인스펙터 프로토콜 엔드포인트로의 연결을 쉽게 하는 라이브러리입니다. +#### [Gitpod](https://www.gitpod.io) + +* `Debug` 뷰에서 Node.js 디버그 설정을 실행하거나 `F5` 키를 누르세요. + [자세한 방법은 여기를 참고하세요.](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1) + --- ## 원격 디버깅 활성화 시나리오 - 디버거가 퍼블릭 IP 주소에서 수신하지 않는 것을 권장합니다. 만약 원격 디버깅 연결을 허용해야 하는 경우 ssh 터널링을 대신 사용할 것을 권장합니다. 설명을 위해 아래 예제를 제공합니다. 진행하기 전 권한을 가진 서비스에 원격 액세스를 허용할 경우 발생할 수 있는 보안 위험을 이해하시기 바랍니다. - 디버깅하기를 원하는 remote.example.com 원격 시스템에서 노드가 실행 중이라고 가정하겠습니다. 해당 시스템에서 localhost(기본값)만 수신하는 인스펙터로 노드 프로세스를 시작해야 합니다. @@ -359,9 +367,9 @@ with the inspector listening only to localhost (the default). $ node --inspect server.js ``` - 이제 디버그 클라이언트 연결을 시작하려는 로컬 시스템에서 ssh 터널을 설정할 수 있습니다. @@ -369,12 +377,12 @@ connection, you can setup an ssh tunnel: $ ssh -L 9221:localhost:9229 user@remote.example.com ``` - +--> 그러면 로컬 시스템의 9221 포트에서 remote.example.com의 9229 포트로 전달되는 ssh 터널 세션이 시작됩니다. Chrome DevTools 또는 Visual Studio Code 등의 디버거로 localhost:9221에 연결 할 수 있으며 Node.js 애플리케이션이 로컬에서 실행 중인 것처럼 디버깅할 수 있습니다. ---