🐳 Docker 이미지 만들기

2023-02-21

💾 도커 이미지를 만들기 위해 Dockerfile 이라는 이미지 빌드용 파일을 사용합니다.

docker_image_build

🎯 Dockerfile 구조

Ruby 웹 애플리케이션을 ubuntu에 배포하는 과정을 통해 구조를 살펴봅니다.

Dockerfile 생성

아래 과정을 쉘 스크립트, Dockerfile로 만들어 비교합니다.

순서  |  작업
---------------------
  |  ubuntu 설치
  |  ruby 설치
  |  소스 복사
  |  Gem 패키지 설치
  |  Sinatra 서버 실행

쉘 스크립트

# 1. ubuntu 설치 (패키지 업데이트)
apt-get update

# 2. ruby 설치
apt-get install ruby
gem install bundler

# 3. 소스 복사
mkdir -p /usr/src/app
scp Gemfile app.rb root@ubuntu:/usr/src/app  # From host

# 4. Gem 패키지 설치
bundle install

# 5. Sinatra 서버 실행
bundle exec ruby app.rb

Dockerfile

## 핵심 명령어는 파일을 복사하는 COPY와 실행하는 RUN 입니다.
# 1. ubuntu 설치 (패키지 업데이트 + 만든사람 표시)
FROM       ubuntu:16.04
MAINTAINER subicura@subicura.com
RUN        apt-get -y update

# 2. ruby 설치
RUN apt-get -y install ruby
RUN gem install bundler

# 3. 소스 복사
COPY . /usr/src/app

# 4. Gem 패키지 설치 (실행 디렉토리 설정)
WORKDIR /usr/src/app
RUN     bundle install

# 5. Sinatra 서버 실행 (Listen 포트 정의)
EXPOSE 4567
CMD    bundle exec ruby app.rb -o 0.0.0.0

쉘 스크립트의 내용을 거의 그대로 Dockerfile로 옮겼습니다. 차이점은 도커 빌드 중엔 키보드를 입력할 수 없기 때문에 (y/n) 을 물어보는 걸 방지하기 위해 -y 옵션을 추가한 것 정도입니다.

이미지 생성

생성한 Dockerfile을 기반으로 이미지를 생성합니다.

# Dockerfile을 만든 디렉토리로 이동하여 다음 명령어를 입력합니다.
# docker build -t [새로 생성할 이미지 이름] [Dockerfile 디렉토리 경로]
$ docker build -t app .

확인

$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
app                 latest              54d239c00f11        4 minutes ago       209 MB
ubuntu              16.04               f49eec89601e        2 weeks ago         129 MB

🎯 Dockerfile 기본 명령어

Dockerfile의 기본적인 명령어를 살펴봅니다.

FROM

하나의 Docker 이미지는 base 이미지부터 시작해서 기존 이미지위에 새로운 이미지를 중첩해서 여러 단계의 이미지 층(layer)을 쌓아가며 만들어집니다.

FROM 명령문은 이 base 이미지를 지정해주기 위해서 사용되는데, 보통 Dockerfile 내에서 최상단에 위치합니다. base 이미지는 일반적으로 Docker Hub와 같은 Docker repository에 올려놓은 잘 알려진 공개 이미지인 경우가 많습니다.

# FROM <이미지>
# FROM <이미지>:<태그>

# Ubuntu 최신 버전을 base 이미지로 사용
FROM ubuntu:latest

MAINTAINER (deprecated)

Dockerfile을 관리하는 사람의 이름 또는 이메일 정보를 적습니다. 빌드에 영향을 주지는 않습니다.

# MAINTAINER <name>

MAINTAINER name@gmail.com

COPY

파일이나 디렉토리를 이미지로 복사합니다. 일반적으로 소스를 복사하는 데 사용합니다. target 디렉토리가 없다면 자동으로 생성합니다.

# COPY [--chown=<user>:<group>] <src>... <dest>
# COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

COPY . /usr/src/app

ADD

COPY 명령어와 매우 유사하나 몇가지 추가 기능이 있습니다. src 에 파일 대신 URL을 입력할 수 있고 src 에 압축 파일을 입력하는 경우 자동으로 압축을 해제하면서 복사됩니다.

# ADD [--chown=<user>:<group>] [--checksum=<checksum>] <src>... <dest>
# ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

ADD . /usr/src/app

RUN

명령어를 그대로 실행합니다. 내부적으로 /bin/sh -c 뒤에 명령어를 실행하는 방식입니다.

# RUN <command>
RUN npm install --silent

# RUN ["executable", "param1", "param2"]
RUN ["/bin/bash", "-c", "echo hello"]

# 멀티라인
RUN /bin/bash -c 'source $HOME/.bashrc && \
echo $HOME'

ENTRYPOINT

ENTRYPOINT 명령문은 이미지를 컨테이너로 띄울 때 항상 실행되야 하는 커맨드를 지정할 때 사용합니다. ENTRYPOINT 명령문은 Docker 이미지를 마치 하나의 실행 파일처럼 사용할 때 유용합니다. 왜냐하면 컨테이너가 뜰 때 ENTRYPOINT 명령문으로 지정된 커맨드가 실행되고, 이 커맨드로 실행된 프로세스가 죽을 때, 컨테이너로 따라서 종료되기 때문입니다.

# ENTRYPOINT ["<커맨드>", "<파라미터1>", "<파라미터2>"]
# ENTRYPOINT <전체 커맨드>
ENTRYPOINT ["npm", "start"]

CMD

Dockerfile에는 하나의 CMD 명령어만 있을 수 있습니다. 둘 이상의 CMD를 나열하면 마지막 CMD만 적용됩니다.

CMD의 주요 목적은 실행 컨테이너에 대한 기본값을 제공하는 것입니다. CMD 명령문은 많은경우 ENTRYPOINT 명령문과 함께 사용하게 되는데, ENTRYPOINT 명령문으로는 커맨드를 지정하고, CMD 명령문으로 디폴트 파리미터를 지정해주면 매우 유연하게 이미지를 실행할 수 있게 됩니다.

CMD ["executable","param1","param2"]
CMD command param1 param2
CMD bundle exec ruby app.rb

WORKDIR

RUN, CMD, ADD, COPY등이 이루어질 기본 디렉토리를 설정합니다. 각 명령어의 현재 디렉토리는 한 줄 한 줄마다 초기화되기 때문에 RUN cd /path 를 하더라도 다음 명령어에선 다시 위치가 초기화 됩니다. 같은 디렉토리에서 계속 작업하기 위해서 WORKDIR 을 사용합니다.

WORKDIR /path/to/workdir

EXPOSE

도커 컨테이너가 실행되었을 때 요청을 기다리고 있는(Listen) 포트를 지정합니다. 여러개의 포트를 지정할 수 있습니다.

# EXPOSE <port> [<port>...]
# EXPOSE <포트>/<프로토콜>

EXPOSE 4567
EXPOSE 9999/udp

참고

EXPOSE 명령문으로 지정된 포트는 해당 컨테이너의 내부에서만 유효하며, 호스트(host) 컴퓨터에서는 이 포트를 바로 접근을 할 수 있는 것은 아니라는 겁니다. 호스트 컴퓨터로부터 해당 포트로의 접근을 허용하려면, docker run 커맨드를 -p 옵션을 통해 호스트 컴퓨터의 특정 포트를 포워딩(forwarding)시켜줘야 합니다.

VOLUME

컨테이너 외부에 파일시스템을 마운트 할 때 사용합니다.

VOLUME ["/data"]

ENV

컨테이너에서 사용할 환경변수를 지정합니다. 컨테이너를 실행할 때 -e 옵션을 사용하면 기존 값을 오버라이딩 하게 됩니다.

# ENV <key> <value>
# ENV <key>=<value> ...
ENV DB_URL mysql

ARG

ARG 명령문은 docker build 커맨드로 이미지를 빌드 시, --build-arg 옵션을 통해 넘길 수 있는 인자를 정의하기 위해 사용합니다.

# 예를 들어, Dockerfile에 다음과 같이 ARG 명령문으로 port를 인자로 선언해주면
ARG port

# 다음과 같이 docker build 커맨드에 --build-arg 옵션에 port 값을 넘길 수가 있습니다.
$ docker build --build-arg port=8080 .



# 인자의 디폴트값을 지정해주면, --build-arg 옵션으로 해당 인자가 넘어오지 않았을 때 사용됩니다.
ARG port=8080

# 설정된 인자 값은 다음과 같이 ${인자명} 형태로 읽어서 사용할 수 있습니다.
CMD start.sh -h 127.0.0.1 -p ${port}

참고

ENV 와 달리 ARG 로 설정한 값은 이미지가 빌드되는 동안에만 유효

.dockerignore 파일

Docker 이미지를 빌드할 때 제외 시키고 싶은 파일이 있다면, .dockerignore 파일에 추가해주면 됩니다.

# .dockerignore\
# 제외 할 파일을 작성
.git
*.md

정리

명령어	용도
FROM	base 이미지 설정
WORKDIR	작업 디렉터리 설정
RUN	이미지 빌드 시 커맨드 실행
ENTRYPOINT	이미지 실행 시 항상 실행되야 하는 커맨드 설정
CMD	이미지 실행 시 디폴트 커맨드 또는 파라미터 설정
EXPOSE	컨테이너가 리스닝할 포트 및 프로토콜 설정
COPY/ADD	이미지의 파일 시스템으로 파일 또는 디렉터리 복사
ENV	환경 변수 설정
ARG	빌드 시 넘어올 수 있는 인자 설정
VOLUME	컨테이너 외부에 파일시스템을 마운트 할 때 사용합니다.

레퍼런스 참고

Dockerfile

🙇🏻‍♂️ 참고사이트

Twitter Facebook LinkedIn

Oh