[따라하며 배우는 도커와 CI환경] 5. Docker Compose

 

📌  Docker Compose 란, 다중 컨테이너 도커 애플리케이션을 정의하고 실행하기 위한 도구 이다.

정의만 보아서는 어떤 도구인지 감이 잘 오지 않을 것이다.
Node.js와 Redis를 이용한 애플리케이션을 만들어보면서 Docker Compose에 대하여 알아보자.

지난 강의에서 Node.js를 사용하여 간단한 애플리케이션을 만들어보았다.
그렇다면 Redis란 무엇일까?

 

✔️ Redis 란?

Redis(REmote Dictionary Server)는 메모리 기반의 키-값 구조 데이터 관리 시스템으로,
모든 데이터를 메모리에 저장하고 빠르게 조회할 수 있는 비 관계형 데이터베이스(NoSql)이다.

 

Redis를 사용하는 이유

• 메모리에 저장하기 때문에 Mysql 같은 데이터베이스에 데이터를 저장하고 불러올 때 보다 훨씬 빠르게 처리할 수 있다.
• 메모리에 저장하지만 영속적으로도 보관이 가능하기 때문에, 서버를 재부팅해도 데이터를 유지할 수 있다.

 

✔️ 애플리케이션 작성 및 도커 환경에서 실행

1️⃣  npm init 으로 package.json 생성

$ npm init

 

2️⃣  의존성에 express, redis를 추가

package.json 파일

{
  "name": "docker-compose-app",
  "version": "1.0.0",
  "description": "",
  "main": "server.js",
  "scripts": {
    "start": "node server.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "dependencies": {
    "express": "4.18.1",
    "redis": "3.0.2"
  },
  "author": "",
  "license": "ISC"
}

redis 버전 주의❗️
4 버전부터는 createClient의 host  프로퍼티를 없어져서 수정이 필요하다.
아래의 server.js 를 그대로 사용할 경우 3버전을 사용하자!!

 

3️⃣  node.js 앱 작성

server.js 파일

const express = require("express");
const redis = require("redis");

// 레디스 클라이언트 생성
const client = redis.createClient({
    // 도커 Compose를 사용할 때는 docker-compose.yml 파일에 명시한 컨테이너 이름으로 주면 된다.
    host: "redis-server",
    // redis 기본 포트 번호(6379)
    port: 6379
})

const app = express();

// 숫자는 0부터 시작
client.set("number", 0);

app.get('/', (req, res) => {
    client.get("number", (err, number)=>{
        // 현재 숫자를 가져온 후에 1씩 올려준다.
        client.set("number", parseInt(number)+1)
        res.send('숫자가 1씩 올라갑니다. 숫자: ' + number)
    })
})


app.listen(9000);
console.log('Server is running');

 

4️⃣ Dockerfile 작성

Dockerfile 파일

FROM node:14

WORKDIR /usr/src/app

COPY ./ ./

RUN npm install

CMD ["node", "server.js"]

 

5️⃣  실행

이제 redis 서버와 Node.js 앱을 실행하자.

redis 서버 실행

$ docker run redis

Node.js 앱 빌드 & 실행

$ docker build -t wisdom/docker-compose-app ./
$ docker run wisdom/docker-compose-app

 

Node.js 앱을 실행하면 다음과 같은 오류가 발생한다.

Error: getaddrinfo ENOTFOUND redis-server
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (dns.js:71:26)
Emitted 'error' event on RedisClient instance at:
    at RedisClient.on_error (/usr/src/app/node_modules/redis/index.js:341:14)
    at Socket.<anonymous> (/usr/src/app/node_modules/redis/index.js:222:14)
    at Socket.emit (events.js:400:28)
    at emitErrorNT (internal/streams/destroy.js:106:8)
    at emitErrorCloseNT (internal/streams/destroy.js:74:3)
    at processTicksAndRejections (internal/process/task_queues.js:82:21) {
  errno: -3008,
  code: 'ENOTFOUND',
  syscall: 'getaddrinfo',
  hostname: 'redis-server'

redis-server 를 찾을 수 없다는 오류이다.
node.js 앱에서 레디스 서버에 접근 할 수 없어서 오류가 발생한 것이다.

이러한 멀티 컨테이너 상황에서, Docker Compose를 사용하면 컨테이너 사이에서 쉽게 통신할 수 있다.

 

✔️ Docker Compose 사용하기

1️⃣  docker-compose.yml 파일 작성

다음과 같이 docker-compose.yml 파일을 작성해보자.

version: "3"
services:
  redis-server:
    image: "redis"
  node-app:
    build: .
    ports:
      - "5000:9000"

redis 서버 컨테이너의 이름을 "redis-server"로, 노드 앱의 컨테이너의 이름을 "node-app"으로 설정하였다.
또한, ports 프로퍼티로 포트 매핑도 지정할 수 있다.

 

2️⃣  앱 실행

# 이미지가 없는 경우, 이미지를 빌드하고 컨테이너 시작
$ docker-compose up			

# 항상 이미지를 빌드하고 컨테이너 시작 (변경사항이 있는 경우 사용)
$ docker-compose up --build		

# detached 모드, 백그라운드에서 실행
$ docker-compose up -d

위의 명령어들을 통해  docker compose 를 사용하여 앱을 실행할 수 있다.
위 명령어를 사용하면, redis 서버와 node 앱이 모두 실행된다.

실행 후 localhost:5000 으로 접속하면 다음과 같은 화면이 나온다.
새로고침을 할 때마다 숫자가 1씩 증가되는 것을 확인할 수 있다.

 

3️⃣ 앱 종료

$ docker-compose down

위의 명령어는 docker compose 를 사용해서 실행한 앱을 종료하는 명령어다.

 

 

참고

• https://www.inflearn.com/course/따라하며-배우는-도커-ci