[Docker] Dockerfile로 이미지 생성하기

이주희·2022년 11월 14일

Docker

목록 보기

13/16

도커는 개발한 애플리케이션을 컨테이너화하는 일련의 과정(컨테이너 생성, 환경 설치, 소스코드 추가, 이미지로 커밋 등)을
손쉽게 기록하고 수행할 수 있는 빌드(build) 명령어를 제공한다.

1. Dockerfile

이미지를 생성하기 위해 컨테이너에 설치해야 하는 패키지, 추가해야 하는 소스코드, 실행해야 하는 명령어와 셸 스크립트 등을 하나의 파일에 기록해 두면 도커는 이 파일을 읽어 컨테이너에서 작업을 수행한 뒤 이미지로 만들어낸다.
👉🏻 이러한 작업을 기록한 파일의 이름을 Dockerfile이라고 부른다.
빌드 명령어는 Dockerfile을 읽어 이미지를 생성한다.
Dockerfile을 사용하면 직접 컨테이너를 생성하고 이미지로 커밋해야 하는 번거로움을 덜 수 있다.
생성한 이미지를 도커 허브 등을 통해 배포할 때 이미지 자체를 배포하는 대신 이미지를 생성하는 방법을 기록해 놓은 Dockerfile을 배포할 수도 있다.
애플리케이션을 컨테이너화하기 위한 장기적인 시점에서 보면 Dockerfile을 작성하는 것은 이미지를 생성하는 방법을 기록하는 것뿐만 아니라 이미지의 빌드, 배포 측면에서도 유리하다.
- 애플리케이션에 필요한 패키지 설치 등을 명확히 할 수 있다.
- 이미지 생성을 자동화할 수 있으며 쉽게 배포할 수 있다.

1-1. Dockerfile 작성하기

한 줄이 하나의 명령어가 된다.
명령어는 소문자로 표기해도 상관없지만 일반적으로 대문자로 표기한다.

FROM node:16
# 베이스가 될 이미지

MAINTAINER juhee
# 이미지를 생성한 개발자의 정보
# 도커 1.13.0 버전 이후로는 사용하지 않는다.(LAVEL로 표현)

LABEL "purpose"="practice"
# 이미지에 메타데이터를 "키:값" 형태로 추가한다.
# 이미지뿐만 아니라 컨테이너, 엔진 등에도 이용할 수 있다.
# 원하는 조건의 컨테이너, 이미지 등을 쉽게 찾을 수 있도록 도와준다.

WORKDIR /class_build/
# 명령어를 실행할 디렉터리. 배시 셸의 cd와 동일하다.

RUN yarn install
RUN yarn build
# 컨테이너 내부에서 실행할 명령어

ADD test.html /var/www/html
COPY . /class_build/
# 이미지에 파일을 추가한다.

EXPOSE 80
# 빌드로 생성된 이미지에서 노출할 포트를 설정한다.
# 이 포트가 호스트의 포트와 바인딩 되는 것은 아님. 나타내는 것뿐!
# 이미지가 실제로 사용될 때 어떤 포트가 사용돼야 하는지 명시할 수 있으며,
# 사용하는 입장에서는 컨테이너의 애플리케이션이 컨테이너 내부에서 어떤 포트를 사용하는지 알 수 있다.

CMD yarn start
# 컨테이너가 시작될 때마다 실행할 명령어(커맨드)

2. 이미지 생성하기

2-1. Dokckerfile 빌드

docker build -t mybuild:0.0 ./

-t 생성될 이미지의 이름을 설정한다.
./ build 명령어의 끝에는 Dockerfile이 저장된 경로를 입력한다.

2-2. 생성된 이미지로 컨테이너 실행

docker run -d -P --name myserver mybuild:0.0

-P EXPOSE로 노출된 포트를 호스트에서 사용 가능한 포트에 차례로 연결한다.

3. 빌드 과정 살펴보기

3-1. 빌드 컨텍스트

이미지 빌드를 시작하면 도커는 가장 먼저 빌드 컨텍스트를 읽는다.
빌드 컨텍스트는 이미지를 생성하는 데 필요한 각종 파일, 소스 코드, 메타데이터 등을 담고 있는 디렉터리를 의미하며, Dockerfile이 위치한 디렉터리가 빌드 컨텍스트가 된다.
빌드 컨텍스트는 Dockerfile에서 빌드될 이미지에 파일을 추가할 때 사용된다.
ADD, COPY 등 이미지에 파일을 추가하는 명령어들은 빌드 컨텍스트의 파일을 이미지에 추가한다.

위치

컨텍스트는 build 명령어의 맨 마지막에 지정된 위치에 있는 파일을 전부 포함한다.
Dockerfile이 위치한 곳에는 이미지 빌드에 필요한 파일만 있는 것이 바람직하다.
루트 디렉터리(/)와 같은 곳에서 이미지를 빌드하지 않도록 주의해야 한다.
👉🏻 단순 파일뿐 아니라 하위 디렉터리도 전부 포함하게 되므로 빌드에 불필요한 파일이 포함된다면, 빌드 속도가 느려질뿐더러 호스트의 메모리를 지나치게 점유할 수도 있다.

.dockerignore

이 파일에 명시된 이름의 파일을 컨텍스트에서 제외한다.
제외할 파일의 경로를 Dockerfile이 존재하는 경로를 기준으로 작성한다.
Dockerfile이 위치한 경로와 같은 곳에 위치해야 한다. ( = 컨텍스트의 최상위 경로 = build 명령어에서 맨 마지막에 오는 경로)

3-2. Dockerfile을 이용한 컨테이너 생성과 커밋

build 명령어로 이미지를 만드는 과정은 하나의 컨테이너에서 일어나는 것이 아니다. ❌
Dockerfile에서 명령어 한 줄이 실행될 때마다 이전 Step에서 생성된 이미지에 의해 새로운 컨테이너가 생성되며, Dockerfile에 적힌 명령어를 수행하고 다시 새로운 이미지 레이어로 저장된다.
(각 Step은 Dockerfile에 기록된 명령어)
이미지의 빌드가 완료되면 Dockerfile의 명령어 줄 수만큼의 레이어가 존재하게 되며, 중간에 컨테이너도 같은 수만큼 생성되고 삭제된다.
이미지 빌드 중 오류가 발생했을 때는 build 명령어가 중지되며, 이미지 레이어 생성을 위해 마지막으로 생성된 임시 컨테이너가 삭제되지 않은 채로 남는다.