[Docker] (9) Dockerfile(도커파일) - 스마트하게 도커 이미지를 빌드하는 방법

Docker 전체 포스팅

[Docker] (1) 도커 개념 설명 | 도커는 왜 사용하는 걸까?

[Docker] (2) 도커 & 도커컴포즈 다운로드

[Docker] (3) 도커 핵심 개념 - 이미지, 컨테이너, 도커 허브

[Docker] (4) docker pull(이미지 다운로드) & docker run(컨테이너 생성/실행) & 포트포워딩(포트매핑)

[Docker] (5) 도커 run 명령어 옵션, 도커 컨테이너가 종료되지 않게 하는 방법

[Docker] (6) 도커 컨테이너로 접속하기 - docker exec & docker attach

[Docker] (7) 도커 volume(볼륨) 옵션 - 컨테이너 폴더와 호스트 폴더 연결하기

[Docker] (8) 도커 commit(커밋) & push(푸시) - 컨테이너를 새로운 도커 이미지로 저장하고 레퍼지토리에 업로드

[Docker] (9) Dockerfile(도커파일) - 스마트하게 도커 이미지를 빌드하는 방법

[Docker] (10) Dockerfile 빌드 예시 | ENTRYPOINT 와 CMD의 차이

[Docker] (11) 도커 컨테이너와 vscode 연동하기 | 도커 컨테이너에서 개발

[Docker] (12) 깃허브로 도커 이미지 공유하기 | Packages Container Registry

 

 

Dockerfile

Dockerfile은 도커 이미지를 생성하기 위한 지시사항들을 포함하는 텍스트 파일로, Dockerfile을 사용하면 도커 이미지를 구성하는 과정을 자동화하고, 이미지가 어떻게 빌드되어야 하는지 세부 사항을 정의할 수 있다. Dockerfile을 사용하면 이미지 빌드를 반복 가능하게 하고, 버전 관리 시스템을 통해 이미지 구성을 관리하기 편하다.

 

도커파일 빌드 vs 컨테이너 커밋

 

도커 이미지를 저장하기 위해서는 도커파일을 빌드할 수도 있고, 컨테이너를 커밋할 수도 있는데 각각 어떤 장단점이 있는지 알아보자.

 

• Dockerfile build (도커파일 빌드)
  • 도커파일은 이미지를 빌드하는 데 필요한 모든 단계를 포함하므로, 이미지 빌드 과정이 완전히 재현 가능
  • 코드와 마찬가지로 버전 관리 시스템을 통해 관리할 수 있음
  • 이미지를 빌드하는 데 필요한 모든 설정과 단계를 하나의 파일에 정의하므로, 이미지의 구성을 쉽게 유지보수할 수 있음

• Container commit (컨테이너 커밋)
  • 간편하게 빠르게 시작할 수 있지만, 도커 파일에 비해 단점이 많음
  • 컨테이너 커밋으로 생성된 이미지는 해당 컨테이너의 변경 사항만을 포함하므로, 컨테이너 커밋을 통해 생성된 이미지를 다른 황경에서 재현하기 힘들 수 있음
  • 프로세스가 런ㄹ타임 중 수행한 변경 사항을 포함할 수 있기에 이미지의 일관성과 안정성이 보장되지 않을 수 있음
  • 이미 실행 중인 컨테이너의 파일 시스템 변경 사항을 그대로 포함하므로 이미지 크기가 커질 수 있음

 

 

Dockerfile 작성

 

Dockerfile을 작성하려면 일반적으로 다음과 같은 단계를 따른다.

1. 베이스 이미지 선택: 이미지를 구성할 때 기존 이미지를 기반으로 시작하는데, 이 이미지를 '베이스 이미지'라고 한다. 예를 들어, 리눅스 배포판이나 어플리케이션 실행 환경을 기본 이미지로 선택.
2. 필요한 파일 및 명령 추가: 베이스 이미지 위에 필요한 파일과 명령을 추가. 파일 복사, 환경 변수 설정, 응용프로그램 설치 등의 작업을 수행할 수 있음.
3. 작업 디렉토리 설정: 이미지 내에서 작업 디렉토리를 설정하여 파일을 추가하거나 명령을 실행하는 위치를 지정.
4. 명령 실행: 이미지 내에서 실행할 명령을 정의. RUN, CMD, ENTRYPOINT 등의 명령을 사용하여 작업을 수행.
5. 포트 노출: 이미지가 실행될 때 개방할 포트를 지정. EXPOSE 명령을 사용하여 컨테이너 내부에서 개방할 포트를 명시.
6. 이미지 메타데이터 설정: 이미지의 메타데이터를 설정할 수 있음. 

이렇게 Dockerfile을 작성한 후, docker build 명령을 사용하여 Dockerfile에 정의된 지시사항에 따라 이미지를 빌드하여 도커 이미지로 저장할 수 있다.

 

명령어	설명	예시
FROM	베이스 이미지 지정	FROM ubuntu:20.04
WORKDIR	작업 디렉토리 설정	WORKDIR /usr/src/app
ENV	환경 변수 설정	COPY app /usr/src/app
COPY	호스트 파일 시스템에서 파일이나 디렉토리를 이미지 내부로 복사	COPY app /usr/src/app
ADD	COPY와 유사하지만 추가 기능을 지원. URL로부터 파일을 다운로드하거나 압축 파일을 풀 수 있음	ADD https://example.com/file.txt /app/
RUN	컨테이너 내에서 실행할 명령어 정의. 패키지 설치, 파일 복사, 응용프로그램 빌드 등	RUN apt-get update && apt-get install -y curl
EXPOSE	컨테이너가 개방할 포트 지정	EXPOSE 80
CMD	컨테이너가 실행될 때 실행할 명령어 지정. `docker run`  명령에서 명령어가 제공되지 않을 경우에만 실행	CMD ["npm", "start"]
ENTRYPOINT	컨테이너가 실행될 때 항상 실행할 명령어. `docker run` 명령에서 추가적인 명령어를 전달하면 해당 명령어가 인자로 사용	ENTRYPOINT ["npm", "start"]
VOLUME	호스트와 컨테이너 간 볼륨을 공유	VOLUME /data

 

Dockerfile 빌드

 

docker build 명령은 도커 이미지를 빌드하기 위해 사용되는 명령어로, 이 명령을 사용하여 도커파일(Dockerfile)에 정의된 지시사항을 따라 이미지를 구성하고 빌드할 수 있다. 도커 이미지 빌드 과정에서 도커파일에 정의된 단계들이 순차적으로 수행되며, 최종적으로 이미지가 생성된다.

 

docker build [옵션] <경로>

여기서 <경로>는 도커파일이 위치한 디렉토리의 경로를 나타내고, 옵션은 이미지 빌드 과정을 조정하고 세부 사항을 지정하는 데 사용된다.

일반적으로 사용되는 옵션들은 다음과 같다:

• -t, --tag: 빌드된 이미지에 태그를 지정. 이미지이름:태그 형식으로 사용.
• -f, --file: 사용할 도커파일의 경로를 지정다. 기본값은 ./Dockerfile
• -q, --quiet: 빌드 진행 상황 메시지를 출력하지 않음
• --build-arg: 도커파일 내에서 ARG 지시문에 전달할 빌드 인자를 지정.

예를 들어, 다음은 현재 디렉토리에 위치한 도커파일을 사용하여 my-image라는 이미지를 빌드하고 태그를 v1.0으로 지정하는 명령어이다.

docker build -t my-image:v1.0 .

 

 

Dockerfile 작성 및 build 예시

 

다음은 Node.js 애플리케이션을 위한 Dockerfile의 예시이다.

# 베이스 이미지 선택
FROM node:14

# 작업 디렉토리 설정
WORKDIR /app

# 애플리케이션 종속성 설치
COPY package.json package-lock.json /app/
RUN npm install

# 애플리케이션 파일 추가
COPY . /app/

# 포트 노출
EXPOSE 3000

# 컨테이너 실행 시 실행될 명령
CMD ["npm", "start"]

Dockerfile을 작성한 후에는 이 파일을 포함하는 디렉토리에서 아래와 같이 docker build 명령을 실행하여 이미지를 빌드할 수 있다.

 

docker build [옵션] [Dockerfile 경로]
docker build -t my-node-app .

위의 명령은 현재 디렉토리(.)에 위치한 Dockerfile을 사용하여 my-node-app라는 이미지를 빌드한다. 이렇게 빌드된 이미지는 docker run을 사용하여 컨테이너로 실행할 수 있다.

 

 

httpd 이미지를 사용한 Dockerfile 작성 및 build 예시

 

미리 작성한 html 파일과 Dockerfile

docker build -t httpd_test ./				
docker run -dit -p 8080:80 httpd_test

• 특정 경로에 index.html 작성 (특정 텍스트 띄우기 위해)
• Dockerfile로 httpd 이미지에 작성한 html 파일을 COPY
• build 하고 포트포워딩 적용한 상태로 run

build, run 명령

 

localhost:8080 확인