실시간 협업을 위한 웹 소켓 노드 서버 도커 실행 가이드입니다.
본 가이드는 웹 소켓 기반의 실시간 협업을 지원하는 서버 환경을 제공합니다. 이를 통해 도커(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