Github 소스코드

🔎 이런거 해볼 거에요

1. 간단한 node app 작성

2. 작성한 node app을 docker image로 만들기 위한 Dockerfile 작성

3. Docker Image 생성

4. 생성된 이미지에서 컨테이너 생성 및 구동 후 접속

간단한 Docker 명령어는 이전 포스트를 확인해주세요 !

---

1. 간단한 node app 작성

node.js를 실습하는 것이 중요한게 아니니 정말 간단하게 만들어볼게요.
(node와 npm이 설치되어 있어야 합니다!)

• npm init (node 프로젝트 생성)
• express 설치 (npm install express --save)
  • docker환경에서 구동하기 위해 package.json에 dependency정보가 저장되어야 해요. 꼭 --save 옵션을 써주세요.

[ index.js ]

const express = require("express");

const port = "8080";

const app = express();

app.get("/", (req, res) => {
  res.send("hello world");
});

app.listen(port);
console.log(`server running on ${port}`);

• 결과를 볼 필요도 없겠지만 일단 확인해봅시다.
  • 서버 On : node index.js
  • 

---

2. 작성한 node app을 docker image로 만들기 위한 Dockerfile 작성

Docker image 를 만들기 위해 Docker image 의 설정정보를 담고 있는 Dockerfile 을 작성해줍니다.

• npm init을 통해 작성한 프로젝트의 root경로에 Dockerfile 을 생성합니다.
  • 

[ Dockerfile ]

# base image (npm을 갖고 있는 baseimage 중 하나)
FROM node:10  

# Working Directory 지정
WORKDIR /usr/src/app

# COPY package.json ./
COPY ./ ./

# node의 종속성 다운로드
RUN npm install

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

• FROM node:10
  • 이미지를 만들기 전 base image를 통해 임시 컨테이너를 생성하고 생성된 임시 컨테이너로 부터 생성하고자 하는 이미지가 생성되는 구조입니다.
  • 우리는 npm 명령어를 필요로 하기에 npm명령어를 포함하는 node:10 이미지를 base image로 사용합니다.
• WORKDIR /usr/src/app
  • working directory를 지정하는 부분입니다.
  • 아래 COPY 부분에서 필요로 하는 소스코드를 컨테이너로 복사해오는데 working directory를 지정하지 않으면 컨테이너의 루트 경로에 폴더 없이 지저분하게 복사되어 좋지 않습니다.
  • 보기 싫은 것도 있지만 COPY시 루트 경로에 COPY되는 파일과 동일한 폴더 혹인 파일이 있다면 덮어쓰는 것으로 알고 있습니다.. 아무튼 위험하니 working directory에 원하는 파일이 복사될 수 있도록 지정해줍시다.
• COPY ./ ./
  • COPY의 첫 번째 인자는 컨테이너로 복사하고자 하는 파일 혹은 폴더입니다. 여기서 ./는 프로젝트의 루트 경로에 있는 모든 폴더 및 파일을 복사한다는 의미겠죠?
  • COPY의 두 번째 인자는 컨테이너에 복사되는 경로로 알고 있는데, 실행해본 결과 working directory를 지정하면 지정한 경로로 복사됩니다.
• RUN npm install
  • 컨테이너 생성 전 수행될 명령어를 적어줍니다.
  • 우리는 컨테이너 생성 전에 필요한 종속성을 받아줘야 합니다.
  • 현재는 express 를 받아와야겠죠??
  • node 기반 애플리케이션은 npm install 명령어를 통해 pacakage.json에 명시된 종속성을 다운로드 할 수 있습니다.
• CMD ["node", "index.js"]
  • 컨테이너 생성 후에 수행할 명령어입니다.
  • 우리는 index.js를 실행시켜 서버를 구동시킬 것 입니다.

---

3. Docker Image 생성

작성한 Dockerfile 에 기반하여 docker build 명령어를 통해 이미지를 생성합니다.

• docker build -t zbeld123/node-app ./
  • -t 옵션: 생성된 이미지에 이름을 부여합니다. 관례로 "dockerID/프로젝트이름" 로 지정해준다고 합니다.
  • -t 옵션을 빼고 한 번 보죠
    - docker build ./ 현재 프로젝트를 docker의 이미지로 빌드한다 ? 정도로 이해해도 될 것 같습니다.
    
• 생성된 이미지를 확인
  • -t 옵션으로 지정한 이름으로 이미지가 생성되었고 base image로 지정한 node도 이미지로 생성되었습니다.
  • 

---

4. 생성된 이미지에서 컨테이너 생성 및 구동 후 접속

이제 컨테이너를 생성해서 서버를 구동시키면 되는데 한가지 설정해줘야 하는게 있습니다.
왜 설정이 더 필요한 것인지 일단 실행시켜보고 알아봅시다.

• docker run zbeld123/node-app 으로 컨테이너를 구동시킨 결과입니다.
  • 
  • 콘솔 로그가 정상적으로 찍힌 것을 보아 제대로 실행된 것 같지만 사실 문제가 있습니다.. 8080 포트로 한 번 접속해보죠.
    • 
  • 접속이 되지 않습니다. 이렇기 때문에 한가지 설정을 더 해주어야 합니다. 👇👇👇👇👇

포트 설정

컨테이너 환경에서의 port와 컨테이너 외부에서 접속하는 port를 매핑시켜주어야 합니다.

• 우리가 node app에서 설정한 port는 컨테이너 환경에서의 port입니다.
• 하지만 우리가 브라우저를 통해 접속하는 것은 컨테이너 외부에서 접속하는 것이기에 port 정보를 매핑 시켜주어야 합니다.
• 예를 들어 우리가 브라우저에서 5000번 포트를 사용하여 접속한다면 5000번 포트를 컨테이너의 포트번호인 8080포트로 매핑시킬 수 있는 매핑 정보가 필요한 것입니다.
• docker run -p [접속할 포트]:[컨테이너의 포트] zbeld123/node-app
  • -p 옵션을 이용하여 매핑정보를 설정할 수 있습니다.

• -p 옵션을 추가하여 컨테이너를 구동시켜봅시다!
  • -p 5000:8000 으로 설정하였으므로 5000번 포트로 접근이 성공하였습니다 !!!
  • 
• -p 옵션을 사용할 때 : 세미콜론의 앞 뒤를 꼭 붙여주셔야 합니다 ㅎ

Docker의 Hello world 퀘스트를 겨우 완수한 느낌..? 이네요 ..! :)