[ SJCE 스터디 / 4주차 ] Docker, Redis, Nodejs(Async/Await), Coroutines

24.09.28(토)

 

[ 💾 Server Part. ]

1. 서버 시작하기(2) - pm2 설치

2025.04.24 - [Study] - [ SJCE 스터디 / 1주차 ] 3-Tier Architecture 기반 클라이언트, 서버 개발 시작하기

[ SJCE 스터디 / 1주차 ] 3-Tier Architecture 기반 클라이언트, 서버 개발 시작하기

1주차에서 Node와 Express를 설치했다. 본격적으로 서버 개발을 시작하기 위한 세팅을 진행해 주었다.

 

1. pm2 설치

 : pm2는 Node.js 애플리케이션을 관리하고 유지하기 위한 프로세스 관리자로, Node.js 서버를 쉽게 실행하고 죽지 않게 유지하고 자동 재시작하고 로그도 보기 편하게 만들어주는 생명 주기를 관리하기 위한 모듈이다.

: node index.js 명령어로 실행 시 백그라운드가 아니라 포그라운드(터미널과 직접 연결된 채로 실행)로 실행하기 때문에 다른 작업을 할 수 없다. 백그라운드(터미널과 별개로 따로 실행 → 터미널에서 다른 작업 가능) 실행까지 가능하게 해주는 것이 pm2이다.

npm install -g pm2

상단 명령어를 통해 설치한다

 

 

📌 pm2 사용법

1. watching 모드 옵션

: 실행된 pm2 소스코드, 프로젝트에 변경사항이 있으면 자동 반영하고 재시작

pm2 start index.js --name game-server --watch

 

pm2 start	PM2로 새로운 앱(프로세스)을 실행하겠다는 명령어
index.js	실행할 Node.js 파일 (당신의 서버 진입점 파일)
--name game-server	실행하는 앱에 "game-server" 라는 이름을 붙이겠다는 뜻
--watch	파일 변경사항을 자동 감지해서 서버를 자동으로 재시작하겠다는 옵션

 

2. 앱 실행

pm2 start index.js	기본 실행 (index.js 실행)
pm2 start index.js --name my-app	이름 지정해서 실행
pm2 start index.js --watch	코드 수정 감지해서 자동 재시작
pm2 start ecosystem.config.js	설정파일(ecosystem) 기반 여러 앱 실행

 

3. 앱 중지 / 재시작 / 삭제 

pm2 stop all	모든 앱 정지
pm2 stop 0	ID 0번 앱만 정지
pm2 stop app-name	이름이 app-name인 앱 정지
pm2 restart 0	ID 0번 앱 재시작
pm2 restart app-name	이름이 app-name인 앱 재시작
pm2 restart 0 --watch	ID 0번 앱 재시작 + 변경 감시 시작
pm2 delete 0	ID 0번 앱 삭제
pm2 delete app-name	이름이 app-name인 앱 삭제
pm2 delete all	모든 앱 삭제

 

4. 앱 상태 / 로그 보기

⭐️ pm2 list	현재 실행 중인 모든 앱 목록 확인
pm2 show 0	ID 0번 앱의 상세정보 보기
pm2 show app-name	이름이 app-name인 앱 상세정보 보기
pm2 monit	실시간 모니터링 대시보드
⭐️ pm2 logs	전체 로그 보기 (실시간)
pm2 logs app-name	특정 앱 로그만 보기
pm2 flush	저장된 로그 초기화 (비우기)

 

5. 서버 재부팅 대비 자동 재시작 설정

pm2 startup	부팅 시 PM2 자동 실행 스크립트 생성
pm2 save	현재 실행 중인 앱 상태 저장 (startup 후 필수)
pm2 resurrect	마지막 저장된 상태로 복구
pm2 reset app-name	앱의 상태 (재시작 횟수 등) 초기화

 

+ index.js 에서 port를 80으로 바꾸면 uptime이 5초정도로 잡힘(그 사이에 restart된 것). 이후 80포트 경로로 접속하면 잘 된다. 리눅스 계열의 서버는 1000번 이하의 포트를 사용하려고 하면 관리자 권한을 필요로 하기 때문에 권한을 물어볼 수 있다.

 

2. 서버 시작하기(2) - Docker, Redis 시작하기

OS의 구조 차이(Mac,Linux vs Windows)에 따른 설치 파일의 차이가 존재한다. OS마다 다 따로 설치하기 번거롭기 때문에 우리는 Docker를 사용한다.

🌐 1. Client Device와 빌드 다양성

Client device는 사용자의 물리적인 하드웨어/OS를 의미한다.

 

Device OS 예시

PC	Windows, macOS
모바일	iOS (iPhone, iPad), Android (AOS, Android OS)

➡ 각각 운영체제가 다르기 때문에,
각 디바이스에 맞게 따로 빌드(컴파일)해서 배포해야 한다.

• Windows용 앱 → .exe
• macOS용 앱 → .app
• iOS 앱 → .ipa
• Android 앱 → .apk

즉, 하나의 소스 코드라도 기기별로 "포맷"과 "환경"을 다르게 맞춰야 한다는 의미이다.

---

🛠️ 2. Docker란?

Docker는 다양한 운영체제(OS) 환경에 관계없이, 컨테이너라는 가벼운 가상환경 위에서 프로그램을 실행할 수 있게 해주는 플랫폼입니다.

✅ 쉽게 말하면:

• "운영체제 종류가 뭐든 상관없이,
  Docker만 깔려 있으면 서버 세팅을 똑같이 할 수 있다!"

서버 OS Docker 설치 가능 여부

Linux (Ubuntu, RedHat, Rocky, CentOS)	가능 ✅
Windows Server	가능 ✅
macOS (개발용)	가능 ✅

➡ 즉, 서버마다 다르게 직접 세팅할 필요 없이, Docker 컨테이너 안에 모든 세팅을 통일할 수 있다.

---

🐳 3. Docker에서 설치할 수 있는 것들

• Node.js
• MongoDB
• Redis
• Nginx
• MySQL
• PostgreSQL

➡ 이런 프로그램들도 Docker 이미지를 통해 쉽게 설치/실행할 수 있다.

docker pull redis
docker pull mongo
docker pull node
docker pull nginx

(공식 인증 마크 있는 이미지를 사용하는 게 안전하다)

---

📦 4. Containers, Port, Files, Exec

✅ Containers 창

• 현재 실행 중인 Docker 컨테이너들을 관리하는 곳
• 각 컨테이너별로 Port 설정, 파일 시스템, 실행 상태 등을 확인 가능

✅ Port

• 호스트(서버)와 컨테이너 간 통신을 연결하는 문.
• 예: localhost:6379 → redis 연결

✅ Files

• 컨테이너 안의 파일 시스템 확인 가능.
• Linux나 macOS의 폴더 구조와 거의 비슷함 (ex. /etc, /var, /usr 등)

✅ Exec

• 컨테이너 안으로 "들어가서" 리눅스 명령어를 직접 칠 수 있는 기능.

docker exec -it container_name bash

• 이걸로 실제 리눅스 서버처럼 명령어 입력 가능.

---

🔗 5. Bind Mounts vs Volume

구분 특징

Bind Mounts	서버의 특정 폴더와 컨테이너의 폴더를 직접 연결→ 서버 파일을 수정하면 컨테이너에도 바로 반영
Volumes	Docker가 자체적으로 관리하는 저장공간→ 컨테이너 삭제해도 데이터 유지 가능 (백업, 이관 용이)

➡ 개발 초반에는 Bind Mounts 사용해서 빠르게 수정하고,
운영(운영 서버)에서는 안정성과 백업을 위해 Volume을 많이 씁니다.

---

📚 6. CommonJS vs ES6 모듈 시스템

✅ CommonJS (cjs)

• 2016년 이전 Node.js 표준
• 모듈 가져오기/내보내기 방식:

// 불러오기
const express = require('express');

// 내보내기
module.exports = someFunction;

➡ 서버 사이드(Node.js)에서 주로 사용됐음.

---

✅ ES6 Modules (esm)

• 최신 자바스크립트 표준 (ECMAScript 2015)
• 브라우저/Node.js 둘 다 사용할 수 있음

// 불러오기
import express from 'express';

// 내보내기
export default someFunction;

➡ 프론트엔드(Vue, React 등)에서는 주로 ES6 모듈을 사용.

---

🔥 cjs vs es6 정리

구분 CommonJS (cjs) ES6 Modules (esm)

사용법	require / module.exports	import / export
기본 적용	예전 Node.js	최신 Node.js, 브라우저
특징	동기 로딩	비동기 로딩 지원
파일 확장자	.js (기본)	.mjs 또는 package.json 설정 필요

 

어떤 모듈을 사용하는지에 따라 (라이브러리 따라) cjs 방식이나 esm 방식 중 하나를 맞춰야 합니다!

 

우선 도커를 사용하기 위해 설치해 준다.

참고로, 도커에 관련된 서비스들은 모두 Linux 기반으로 설치된다. (containers 창의 port > files를 열람해보면 Linux나 mac의 구조와 파일 구조가 거의 동일함을 알 수 있다) 

 

 

Step 1. Docker Desktop Install

-       mac : https://docs.docker.com/desktop/install/mac-install/

-       windows : https://docs.docker.com/desktop/install/windows-install/

상단 링크에서 Docker.dmg를 다운받고 드래그앤 드롭하는 GUI 방식으로 설치를 진행했더니 문제가 발생하는 경우가 꽤 있다..
하단 명령어를 통해, CLI 방식으로 설치를 진행하자.

sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker​

참고 ➡️ https://docs.docker.com/desktop/setup/install/mac-install/

 

Step 2. Redis, Mongo 이미지 설치

: 인증 표시를 잘 확인해서 설치할 것

 

우선 설치까지만 해두고 optional settings 설정과 띄우는 방법에 대해서는 후설하겠다.

 

 

 

 

 

3. 동기 / 비동기

동기 : 하나의 작업이 끝나기를 기다렸다가 다음 작업을 실행

비동기 : 선행 작업을 기다리지 않고 병렬적으로 작업 처리

 

Await : 기다려라! <- 동기 방식

Async/Await : 비동기 작업의 동기 처리 방식

cf) 비동기 처리 패턴 Promise

 

사용하는 이유?

 

Redis와 같은 DB에 연결(connect)이 완료된 이후에 데이터를 조회해야 한다면, 비동기 작업의 순서를 보장할 필요가 있다. 그렇지 않으면 조회 시점에 DB 연결이 되지 않아 오류가 발생할 수 있다. 이런 경우 await를 사용하면 DB 연결이 완료될 때까지 기다린 후 그 다음 작업을 처리할 수 있어 순서를 보장할 수 있다.

-       await 구문의 마지막까지 다 수행하고 난 뒤 다음 코드 수행

-       비동기는 프로세스가 분리가 됨

 

 

시간 지연 함수 setTimeout으로 delay 함수 구현

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function fetchUserInfo() {
  await delay(1000); // 1초 대기
  console.log("유저 정보를 가져왔습니다.");
}

 

 

Node express의 get 요청과 Redis Client의 set을 사용하여 사용자 정보 넘겨주기

app.get("/user", async (req, res) => {
  await redisClient.set("user", JSON.stringify({ name: "희" }));
  const user = await redisClient.get("user");
  res.send(user);
});

 

 

 

[ 🖥️Client Part. ]

1. 코루틴(Coroutines) 및 클라이언트-서버 연결

 

💡 코루틴이란?

: 코루틴은 유니티에서 비동기 처리(혹은 시간 간격 처리)를 할 수 있도록 도와주는 특수한 함수이다. 일반 함수와는 달리 중간에 멈췄다가(yield) 나중에 다시 이어서 실행할 수 있다.

 

IEnumerator MyCoroutine() {
    for (int i = 0; i < 10; i++) {
        Debug.Log($"로그 출력 {i + 1}");
        yield return new WaitForSeconds(1f); // 1초 대기
    }
}

• IEnumerator: 코루틴 함수는 반드시 이 반환 타입을 사용해야 함
• yield return: 중간에 잠시 멈췄다가 다시 이어서 실행할 수 있도록 하는 키워드
• StartCoroutine(MyCoroutine()): 코루틴을 시작할 때 사용

 

 

📌 클라이언트-서버 연결 실습

유니티에서 외부 서버(Redis 등)와 연동하여 데이터를 주고받는 기본 흐름이다.

1. 로고 씬에 버튼 생성
   • 서버 연결 테스트를 위한 UI 버튼을 생성합니다.
   • UI → Button 선택 후 적절한 위치에 배치.
2. 네트워크 매니저 오브젝트 생성
   • 빈 GameObject를 생성하고 이름을 NetworkManager로 지정합니다.
3. 네트워크 매니저 스크립트 작성
   • NetworkManager.cs라는 이름으로 C# 스크립트를 생성하고, 다음과 같은 코드 작성

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

public class NetworkManager : MonoBehaviour {
    public void OnConnectButtonClicked() {
        StartCoroutine(GetDataFromServer());
    }

    IEnumerator GetDataFromServer() {
        string url = "http://<서버주소>/api/test"; // 실제 서버 주소로 변경
        UnityWebRequest request = UnityWebRequest.Get(url);
        yield return request.SendWebRequest();

        if (request.result == UnityWebRequest.Result.Success) {
            Debug.Log("서버 응답: " + request.downloadHandler.text);
        } else {
            Debug.LogError("서버 연결 실패: " + request.error);
        }
    }
}

 

4. 버튼과 스크립트 연결

• 버튼의 OnClick() 이벤트에 NetworkManager 오브젝트를 등록한 뒤, OnConnectButtonClicked 함수를 연결

5. 테스트 데이터 확인

• 서버가 띄워져 있는 상태에서 버튼 클릭 시 Redis에 저장된 테스트 데이터를 불러올 수 있는지 확인

 

그리고 지난 주 과제였던 캐릭터와 몬스터가 충돌 시 일정 횟수 공격 이후 다시 지나가게끔 구현도 마무리했다 ✌🏻