dockerfile 명령어 정리

[Gunju-Ko]

Dockerfile

• 이미지를 만들기 위해 Dockerfile이라는 파일에 자체 DSL 언어를 이용해서 이미지 생성 과정을 적는다.
• 애플리케이션을 도커 이미지로 만드는 과정을 도커라이징이라고 한다.
• 빌드 명령어를 실행한 디렉터리의 파일들을 빌드 컨텍스트라고 한다. 이 파일들은 도커 서버로 전송된다.
• 도커 빌드는 임시 컨테이너 생성 > 명령어 수행 > 이미지로 저장 > 임시 컨테이너 삭제 > 새로 만든 이미지 기반 임시 컨테이너 생성 > 명령어 수행 > 이미지로 저장 > ... 의 과정을 계속해서 반복한다. 명령어를 실행할 떄마다 이미지 레이어를 저장하고 다시 빌드할 때 Dockerfile이 변경되지 않았다면 기존에 저장된 이미지를 그대로 캐시처럼 사용한다.

# 이미지 빌드하기
$ docker build -t [tag name] [Directory of Dockerfile]

$ docker build -t app .

[Gunju-Ko]

참고

• 아래 링크를 참고하면 다양한 DockerFile 볼 수 있다.

  • https://github.com/search?utf8=%E2%9C%93&q=dockerfile%EF%BF%BC

• 다양한 베이스 이미지는 Docker hub에서 확인할 수 있다.

  • https://hub.docker.com/search?q=&type=image

• 공식문서

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

• 잘 정리된 블로그

  • https://www.daleseo.com/dockerfile/
  • https://subicura.com/2017/02/10/docker-guide-for-beginners-create-image-and-deploy.html

[Gunju-Ko]

VOLUME

• 컨테이너 외부에 파일시스템을 마운트 할 때 사용한다.
• 컨테이너 안에 있는 데이터는 컨테이너가 삭제될 때 같이 삭제된다.
• 컨테이너 데이터를 보존하고 싶다면 VOLUME 명령어를 사용해야한다.
• VOLUME 명령은 설정한 컨테이너의 데이터를 호스트 OS에 저장한다.
  • 컨테이너끼리 데이터 공유를 가능하게 한다.
• 생성한 볼륨은 호스트 OS의 /var/lib/docker/volumes에 생성되며, Docker에서 자동 생성한 해쉬값으로 디렉터리가 생긴다.

VOLUME /tmp
VOLUME ["/data"]

*run에서 호스트 OS이 경로를 변경할 수 있다.

docker run -it -v /root/docker/log/:/var/log/ centos /bin/bash

[Gunju-Ko]

FROM

• 베이스 이미지를 지정 (필수)

FROM ubuntu:16.04

MAINTAINER

• Dockerfile을 관리하는 사람의 이름 또는 이메일 정보
• 빌드에 영향을 주진 않음

MAINTAINER gunju.ko

COPY

• 파일이나 디렉터리를 이미지로 복사한다.
• 일반적으로 소스를 복사하는데 사용한다.
• target 디렉터리는 자동으로 생성한다.
• 상대 경로를 사용할 때는 WORKDIR 명령문으로 작업 디렉터리를 지정하는게 좋다.

COPY <src>... <dest>
COPY . /usr/src/app

ADD

• COPY와 유사하나 몇가지 추가 기능이 존재
  • src에 파일 대신 URL 입력 가능
  • src에 압축 파일을 입력하는 경우 자동으로 압축을 해제하면서 복사

RUN

• 명령어를 그대로 실행한다.
• 이미지 빌드 과정에서 필요한 커맨드를 실행하기 위해서 사용된다.
• 보통 이미지 안에 특정 소프트웨어를 설치하기 위해서 많이 사용된다.
• 내부적으로 /bin/sh -c 뒤에 명령어를 실행하는 방식

RUN ["executable", "param1", "param2"]
RUN bundle install

CMD

• 도커 컨테이너가 실행되었을 때 실행되는 명령어를 정의 or ENTRYPOINT 명령문으로 지정된 커맨드의 디폴트로 넘길 파라미터를 지정할 때 사용
• 빌드할 때 실행되지 않으며 여러 개의 CMD가 존재할 경우 가장 마지막 CMD만 실행

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

• node 커맨드로 디폴트로는 index.js를 실행하되, docker run 커맨드에 인자가 있는 경우, 해당 인자를 실행하고 싶은 경우, 다음과 같이 Dockerfile을 작성

ENTRYPOINT ["node"]
CMD ["index.js"]

# node index.js 실행
$ docker run test

# node main.js 실행
$ docker run test main.js

ENTRYPOINT

• 이미지를 컨테이너로 띄울 때 항상 실행되어야 하는 커맨드를 지정할 때 사용
• ENTRYPOINT는 도커 이미지를 하나의 실행 파일처럼 사용할 때 유용
  • 컨테이너가 뜰 때 ENTRYPOINT 명령문으로 지정된 커맨드가 실행되고, 이 커맨드로 실행된 프로세스가 죽을 때, 컨테이너도 따라서 종료

ENTRYPOINT ["python", "manage.py", "runserver"]

WORKDIR

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

EXPOSE

• 도커 컨테이너가 실행되었을 때 요청을 기다리고 있는 포트를 지정
• 여러개 지정 가능
• EXPOSE 명령문으로 지정된 포트는 해당 컨테이너 내부에서만 유효하며, 호스트 컴퓨터에서는 이 포트를 접근할 수 없다. (호스트 컴퓨터에서 접근하려면 -p 옵션을 통해 호스트 컴퓨터의 특정 포트는 포워딩 시켜줘야 한다.)

EXPOSE 4567

ENV

• 컨테이너에서 사용할 환경 변수를 지정
• 컨테이너 실행시 -e 옵션을 사용하면 기존값을 오버라이딩
• 컨테이너에서 실행되는 애플리케이션도 접근 가능

ENV <key> <value>
ENV DB_URL mysql

ARG

• docker build 커맨드로 이미지 빌드시 --build-arg 옵션을 통해 넘길 수 있는 인자를 정의

ARG port=8080

$ docker build --build-arg port=8080 .

• docker build 커맨드에서 --build-arg 옵션에 port 값을 넘길 수 있다.
• --build-arg 옵션으로 해당 인자가 들어오지 않으면 디폴트 값을 사용한다.
• 설정된 인자값은 아래와 같이 사용할 수 있다.

CMD start.sh -h 127.0.0.1 -p ${port}

출처

• https://subicura.com/2017/02/10/docker-guide-for-beginners-create-image-and-deploy.html