2016년 12월 11일 일요일

socketcluster tutorial - 4. 디버깅 (Debugging)

디버깅


일반적인 NodeJS 프로세스를 디버그하는 것과 거의 같은 방법으로 SC 프로세스를 디버그 할 수 있습니다. 유일한 차이점은 SC에는 다양한 방식으로 서로 상호 작용하는 여러 종류의 프로세스가 있기 때문에 일반적으로 동시에 모두를 디버그하는 일은 없습니다. 이러한 이유로 SC에서는 --debug-workers--debug-brokers CLI 인수를 제공하여 워커와 브로커를 각각 디버그 할 수 있습니다. Node.js 버전 6.3.0 이상을 사용하는 경우 --inspect-workers--inspect-broker를 사용하면 외부 디버거를 실행할 필요가 없습니다.

저, Node.js v0.11.0 + (가장 최근의 안정 버전)을 사용하고 있는지 확인하십시오.

Node-inspector를 전역으로 설치하십시오 (Node.js v6.3.0 이상인 경우 이 단계를 건너 뜁니다).
npm install -g node-inspector
그런 다음 콘솔 창에서 다음을 사용하여 실행하십시오:
node-inspector
^ 전체 디버깅 세션에 걸쳐 이 콘솔을 자체 콘솔 (또는 백그라운드)에서 실행해야합니다 (개별 디버그 사이에서 다시 시작할 필요가 없습니다).

디버깅을 시작하려면 새로운 콘솔을 열어야합니다. Node를 사용하여 server.js 파일을 실행할 때 --debug-workers, --debug-broker, --inspect-workers 또는 --inspect-brokers 인수를 전달해야합니다. 서버 파일 이름 에 플래그를 추가하십시오. 그렇지 않으면 작동하지 않습니다.

예를 들면
node server --debug-workers
혹은
node server --debug-brokers
또는 (Node.js version >= 6.3.0)
node server --inspect-workers
또는 (Node.js version >= 6.3.0)
node server --inspect-brokers
첫 번째 워커의 기본 디버그 포트는 5859이고 두 번째 워커는 5860입니다 (각 워커마다 하나씩 증가합니다) - 디버그 메시지를 콘솔에 출력하여 어떤 디버그 포트가 열려 있는지 알려줍니다.

첫 번째 작업자의 디버그 콘솔을 열려면 이 주소를 Chrome 브라우저 (디버그 포트 5859)에 삽입해야 합니다. http://127.0.0.1:8080/debug?ws=127.0.0.1:8080&port=5859

Node.js> = v6.3.0 인 경우 콘솔에 제공된 두 번째 URL을 복사하여 첫 번째 워커를 디버그합니다 (제공된 첫 번째 URL은 master workerCluster 프로세스 용임).

또한 워커를 위한 사용자 시작 포트를 지정할 수도 있습니다. 첫 번째 포트는 워커에 할당됩니다. 클러스터 마스터 - SC 작업자를 관리하는 프로세스입니다.-는 일반적으로 디버깅 할 필요가 없습니다. 첫 번째 워커의 디버그 포트는 지정된 포트 + 1이고 그 뒤론 +1씩 증가합니다.
// workerCluster 프로세스는 포트 5999에서 디버깅할 수 있습니다.
// 첫 번째 워커는 포트 6000에서 디버깅 할 수 있습니다.
node server --debug-workers=5999
이는 브로커에도 적용됩니다:
// 첫 번째 브로커는 포트 5999에서 디버깅할 수 있습니다.
node server --debug-brokers=5999
Node.js v6.3.0 이상을 사용하는 경우 위의 'debug'키워드를 'inspect'로 대체하면 본질적으로 동일한 방식으로 작동합니다. 디버거 URL이 콘솔에 표시되는지 확인해야 합니다. 그냥 복사해서 브라우저에 붙여 넣기만 하면 됩니다.

마스터 프로세스(server.js)를 디버그하려면 일반적인 방식으로 하면 됩니다.
node --debug-brk server
혹은 Node.js >= v6.3.0이라면:
node --inspect server
^이 경우에도 순서가 중요합니다. (이번에는 --debug-brk 또는 --inspect가 서버 인수보다 에 있어야합니다!)

워커를 디버깅 할 때 가끔 특정 행에서 중단시키거나 계속 진행할 하고자 할 것입니다.(유휴 상태, 연결 대기 중). 이렇게 하려면 worker.js 코드에서 당신이 멈추고자하는 곳에 debugger; 명령을 추가해야합니다.

워커의 경우 전역 worker 객체(디버거 콘솔에서)에 접근할 수 있으므로 서버와 상호 작용하고 worker.exchange.publish( 'pong', 'This is a message for the pong channel')를 워커로부터 당신의 다른 시스템과 상호작용. (이 기능에 액세스하려면 코드의 아무 곳이나 debugger 문을 추가할 필요가 없습니다. 워커 변수는 모든 범위에서 액세스 할 수 있도록 전역에 노출됩니다.)

마찬가지로 브로커 프로세스를 디버깅 할 때 브로커 객체에 액세스 할 수 있으며 작업자와 마찬가지로 디버거를 통해 브로커와 직접 상호 작용할 수 있습니다.

주제를 조금 벗어나 : 여러 브로커를 사용하는 경우 각 브로커는 사용 가능한 모든 채널의 하위 집합만 관리합니다 (SC의 확장성에 대한 비밀스런 소스입니다). 따라서 브로커에게 publish()하면 아무도 메시지를 받지 못합니다. 특정 채널을 담당하는 브로커에서 publish()를 호출해야합니다.