[Docker] Express 서버 앱 도커 파일 빌드 (도커 이미지 생성)

기존 블로그에 포스팅했던 테스트용 Express 앱을

Git Repository(깃 원격 저장소)에 연결 후 해당 프로젝트를

WLS2 우분투 환경에서 해당 프로젝트 clone 후 도커 파일 빌드 진행

 

Express 서버 구축 : https://coding-gym.tistory.com/entry/Nodejs-Express-%EC%84%9C%EB%B2%84-%EA%B5%AC%EC%B6%95?category=1127022

[Node.js] Express 서버 구축

Git 원격 저장소 연결 : https://coding-gym.tistory.com/entry/Git-Git-%EC%9B%90%EA%B2%A9-Repository-%EC%83%9D%EC%84%B1-%EB%B0%8F-%EB%A1%9C%EC%BB%AC-Repository-%EC%97%B0%EA%B2%B0

[Git] Git 원격 Repository 생성 및 로컬 Repository 연결

---

[ 비공개 깃 원격 저장소(Private Git Remote Repository) 토큰 생성 및 권한 부여 ]

 - 이전 블로그 포스팅을 통해 생성했던 Express 앱이 저장되어 있는

   원격 깃 저장소에서 해당 프로젝트를 clone

   (이 때 해당 프로젝트가 private일 경우 토큰 생성 및 권한 부여 과정 필요)

 

   1. 본인 깃허브 계정에 로그인 후 우측 상단의 설정 페이지로 접속

우측 상단의 프로필 클릭 후 Settings 페이지 접속

 

   2. 좌측 하단의 'Developer settings' 클릭 후 'Personal access tokens(classic) 클릭'

 

   3. Generate new token(classic) 버튼 클릭 → 로그인 → 옵션 설정 후

       하단의 'Genarate token'  버튼을 클릭하여 토큰 생성

       - 토큰명 설정 및 권한 부여

       - 필요 상황과 옵션에 따라 권한 부여

          (repo, workflow, write:packages, gist, notifications, user, write:discussion) 

토큰 옵션 설정

 

   4. 생성 완료된 토큰 값은 개인이 따로 비공개로 보관

 

 

[ 깃 원격 저장소 clone ]

 1. WSL2를 통해 우분투 환경에 접속

 2. git clone 명령을 통해 비공개 원격 깃 저장소 clone

     (WSL 터미널에서 붙여넣기 시 Ctrl + Shift + v)

 3. Username 입력

     => Username for 'https://github.com': <본인 깃허브 유저명>

     => Password for 'https://<본인 깃허브 유저명>@github.com': <위에서 발급한 토큰 값>

$ git clone <Git URL>

// 특정 브랜치를 클론할 경우
$ git clone -b <브랜치명> --single-branch <Git URL>

 

 4. npm install 명령을 통해 Node.js 종속성 설치

/*
 *프로젝트 package-json에 명시 되어 있는
 * Node.js 종속성 파일들(node_modules) 설치
 */
$ npm install

 

 

[ Docker 파일 생성 ]

 - Dockerfile : 도커 이미지를 빌드하는 스크립트 파일로써

                      베이스 이미지의 저장소, 설치할 패키지, 앱 코드 및 설정 파일,

                      컨테이너 동작 시 실행 될 명령어 내용등을 담고 있음    

 - Dockerfile [옵션]

    1. FROM : Docker Base Image(기반이 되는 이미지, <이미지명>:<태그> 형식)

    2. MAINTAINER : 작성자 정보

    3. RUN : Shell Script 또는 명령 실행

    4. CMD : 컨테이너가 실행될 경우 해당 명령 실행

    5.  LABEL : 라벨 작성

    6. EXPOSE : 호스트와 연결할 포트 번호 설정

    7. ENV : 환경변수 설정

    8. ADD : 파일 / 디렉토리 추가

    9. COPY : 파일 복사

    10. ENTRYPOINT : 컨테이너가 시작되었을 때 해당 스크립트 실행

    11. VOLUME : 볼륨 마운트

    12. USER : 명령 실행 사용자 권한 지정

    13. WORKDIR : 'RUN', 'CMD', 'ENTRYPOINT' 등 명령이 실행될 작업 디렉토리

    14. ARG : Dockerfile 내부 변수 지정

    15. ONBUILD : 다른 이미지의 Base Image로 쓰일 경우 실행될 명령 수행

    16. SHELL : Default Shell 지정

 

 - 앱 프로젝트 경로로 이동하여 Dockerfile 생성 및 스크립트 내용 작성

 - Docker 빌드 시 RUN 커맨드 실행 요건의 경우

   1. 최초 빌드의 경우 RUN 명령이 반드시 실행

   2. 재빌드인 경우 COPY된 소스코드 파일 중 변경사항이 하나라도 있을 경우 실행

       만약 종속성 파일들의 변화가 없을 경우 굳이 npm install을 두번 수행할 필요가 없으므로 

       COPY 부분을 두 개로 나누어서 진행

Dockerfile 작성

 

 

[ Docker 파일 빌드 ]

 - 해당 Dockerfile이 존재하는 프로젝트 경로에서 명령어 사용

// docker build -t <이미지명><태그명> <이미지 생성 위치>
$ docker build -t express_test .

베이스 이미지가 되는 node 이미지와 빌드한 express_test 확인

 

 

[ 생성 이미지 컨테이너 실행 ]

// 컨테이너 생성 및 포트 연결, 백그라운드 시작 
$ docker run -d -p 5000:3000 express_test

로컬 환경에서 컨테이너 실행 확인

 

 

 

---

참고 : https://narup.tistory.com/206

[Dockerfile] Dockerfile express 연동하기

참고 : https://narup.tistory.com/204

[Dockerfile] Dockerfile이란? Dockerfile 옵션

참고 : https://velog.io/@pinion7/%EB%8F%84%EC%BB%A4-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%83%9D%EC%84%B1%ED%95%B4%EB%B3%B4%EA%B8%B0-2%ED%8E%B8feat.-Node.js-Dockerfile

도커 이미지 생성해보기 2편(feat. Node.js, Dockerfile)