Dockerfile 구조

Dockerfile 이라는 파일에 docker에서 필요한 설정들을 해서 컨테이너를 원하는대로 설정할 수 있다.

Dockerfile을 생성한 후 아래처럼 소스경로를 포함해서 빌드명령을 내리면 해당 경로를 기준으로 빌드가 실행된다.

docker build /your/source/path

빌드에서 제외할 파일들은 .dockerignore 파일에 명시해서 제외할 수 있다.

Dockfile안의 명령어들은 독립적으로 실행되어서 다음에 실행되는 명령에 영향을 미치지 않는다.

Dockfile 구조

#을 이용해서 주석처리

"명령어 인자”의 형식

명령어는 대소문자를 구분하지는 않으나 가급적 대문자를 이용하는것이 보기 좋음.

각 명령어는 위에서부터 순서대로 실행됨

첫번째 명령어는 반드시 ‘FROM'이어야 함. 

ENV 명령어로 환경변수를 선언해서 사용할 수 있음.

사용할때는 ‘$변수명’, ‘${변수명}’ 형식으로 사용함.

예제

FROM busybox ENV foo /bar WORKDIR ${foo} # WORKDIR /bar ADD . $foo # ADD . /bar COPY \$foo /quux # COPY $foo /quux

환경변수를 이용가능한 명령어들

ENV, ADD, COPY, WORKDIR, EXPOSE, VOLUME, USER

명령어 설명

FROM <image>

FROM <image>:<tag>

Dockerfile에서 사용되는 기본 이미지를 설정함.

항상 Dockerfile의 가장 처음에 와야함.

tag가 없으면 기본으로 latest를 이용함.

MAINTAINER <name>

이미지를 만든 사람을 명시함.

RUN <command>

RUN [“executable”, “param1”, “param2”]

현재 이미지의 최상단 레이어에서 명령어(command)를 실행하고 결과를 커밋(commit)함.

커밋된 이미지는 Dockerfile의 다음 단계에 이용됨.

CMD ["executable","param1","param2"]

CMD ["param1","param2"]

CMD command param1 param2

컨테이너에서 실행할 명령어. 

하나의 Dockerfile에서 한번만 사용할 수 있는 명령이고, 여러개가 있을 경우에는 가장 마지막에 있는 CMD만 실행됨.

EXPOSE <port> [<port>...]

컨테이너가 실행중에 열리는 포트를 명시

ENV <key> <value>

ENV <key>=<value>

환경부 <key>에 값인 <value>를 할당.

ADD <src>... <dest>

<src>에 있는 파일, 디렉토리, 원격 URL를 <dest>에 명시된 컨테이너의 파일시스템으로 복사한다.

<src>는 docker build 에서 명시한 경로의 하위여야 함. 

<dest>는 절대경로여야 함.

COPY <src>... <dest>

<src>에 있는 파일이나 디렉토리를 컨테이너의 <dest> 경로에 복사한다.

<src>는 docker build 에서 명시한 경로의 하위여야 함. 

<dest>는 절대경로여야 함.

ENTRYPOINT ["executable", "param1", "param2"]

ENTRYPOINT command param1 param2

ENTRYPOINT를 이용해서 컨테이너를 실행가능한 형태로 만들수 있다.

VOLUME ["/data"]

지정된 이름으로 마운트 지점을 생성한다.

USER daemon

이미지를 실행할때 사용할 사용자명이나 UID를 지정한다.

WORKDIR /path/to/workdir

RUN, CMD, ENTRYPOINT 명령어가 실행되는 작업 디렉토리를 설정한다.

ONBUILD [INSTRUCTION]

현재 이미지가 나중에 다른 빌드의 기본 이미지로 사용될때, 그때 이 이미지에 실행될 트리거 명령을 추가한다. 

Dockerfile 예제

# Nginx # # VERSION 0.0.1 FROM ubuntu MAINTAINER Victor Vieux <victor@docker.com> RUN apt-get update && apt-get install -y inotify-tools nginx apache2 openssh-server # Firefox over VNC # # VERSION 0.3 FROM ubuntu # ‘fake’ 디스플레이와 파이어폭스를 만들기위해 vnc, xvfb 설치 RUN apt-get update && apt-get install -y x11vnc xvfb firefox RUN mkdir ~/.vnc # 패스워드 설정 RUN x11vnc -storepasswd 1234 ~/.vnc/passwd # 파이어폭스 자동시작 RUN bash -c 'echo "firefox" >> /.bashrc' EXPOSE 5900 CMD ["x11vnc", "-forever", "-usepw", "-create"] # 다중 이미지 예제 # # VERSION 0.1 FROM ubuntu RUN echo foo > bar # 출력은 다음과 같다. ===> 907ad6c2736f FROM ubuntu RUN echo moo > oink # 출력은 다음과 같다.===> 695d7793cbe4 # /bar를 가진 907ad6c2736f, /olink를 가진 695d7793cbe4 2개의 이미지가 생성됨.

참고

https://docs.docker.com/reference/builder/