실시간 협업을 위한 웹 소켓 노드 서버 도커 실행 가이드입니다.
본 가이드는 웹 소켓 기반의 실시간 협업을 지원하는 서버 환경을 제공합니다. 이를 통해 도커(Docker)를 사용하여 서버 환경을 구축하고 관리할 수 있습니다.

웹 소켓 서버의 설치 및 실행을 위해 필요한 tar 파일은 별도의 요청을 통해 제공됩니다.
도커 환경에서의 웹 소켓 서버 구축을 원하시는 경우, 기술지원팀으로 연락주시면 상세한 안내와 함께 필요한 파일(tar)을 전달해 드립니다.

목차

이미지 생성

• 웹 소켓 서버 tar 파일 설치 경로로 이동한 후 아래의 명령어를 통해 웹 소켓 서버 이미지를 생성할 수 있습니다.

# 웹 소켓 서버 이미지 tar파일 설치 경로로 이동
cd <tar 파일 설치 경로>

# load 명령어로 tar파일을 이미지화
docker load -i <파일명>.tar

# 예시
cd C:/workspace
docker load -i collaboServer.tar

이미지 확인

• 웹 소켓 서버 이미지가 생성되었는 지 확인합니다.

# 이미지가 생성되었는 지 확인 
docker images

컨테이너 시작

• 생성된 웹 소켓 서버 이미지를 실행시킵니다.

# 이미지 실행
docker run -e PORT=<내부 포트 번호> -p <호스트 포트 번호>:<내부 포트 번호> <이미지ID>

# 예시
docker run -e PORT=1234 -p 1234:1234 0e8f4af55097
docekr run -d -e PORT=1234 -p 1234:1234 0e8f4af55097 # 백그라운드 실행

• 호스트 포트 번호 : 외부 서비스가 호스트의 이 포트로 접근하면, 해당 요청이 컨테이너로 포워딩됩니다.
• 내부 포트 번호 :  컨테이너가 내부적으로 사용하는 포트로, 호스트의 포트 요청을 이 포트로 리디렉션합니다.

컨테이너 동작 확인

• 실행중인 웹 소켓 서버를 확인합니다.

# 실행중인 컨테이너 목록
docker ps -a

컨테이너 종료

• 실행중인 웹 소켓 서버를 종료합니다.

# 컨테이너 종료
docker stop <컨테이너 ID>

# 예시
docker stop 62409c6ddba3

프로세스 상태 모니터링 및 관리

• 웹소켓 서버의 프로세스 상태 모니터링 및 관리를 위해 pm2의 기능을 사용할 수 있습니다.

• pm2는 Node.js 애플리케이션의 프로세스 관리 도구로, 애플리케이션의 실행 상태를 지속적으로 모니터링하고, 비정상 종료 시 자동으로 재시작하는 기능을 제공합니다.

# 컨테이너 접속
docker -it exec <컨테이너 ID> /bin/bash

# 프로세스 상태 모니터링
pm2 monit