Dockerfile 간단 정리

[시작하세요! 도커/쿠버네티스 - www.yes24.com/Product/Goods/93765519]

 

FROM ubuntu:14/04
MAINTAINER alicek106
LABEL "purpose"="practice"
RUN apt-get update
RUN apt-get install apache2 -y
ADD test.html /var/www/html
WORKDIR /var/www/html
RUN ["/bin/bash", "-c", "echo hello >> test2.html"]
EXPOSE 80
CMD apachectl -DFOREGROUND

• FROM : 생성할 이미지의 베이스가 될 이미지
  • Dockerfile 작성 시에 반드시 한 번 이상 입력해야 됨
• MAINTAINER : 이미지를 생성한 개발자의 정보
  • 도커 1.13.0 버전 이후로 사용하지 않음. 대신 LABEL 사용
• LABEL : 이미지에 메타데이터를 추가
  • 메타데이터는 '키:값' 형태로 저장됨
  • 여러 개의 메타 데이터가 저장될 수 있음
  • docker inspect 명령어로 추가된 메타 데이터 확인 가능
• RUN : 이미지를 만들기 위해 컨테이너 내부에서 명령어를 실행
• ADD : 파일을 이미지에 추가
  • 추가하는 파일은 Dockerfile이 위치한 디렉터리인 컨텍스트(Context)에서 가져옴
  • JSON 배열의 형태로 사용할 수 있음
    • 배열의 마지막 원소가 컨테이너에 추가될 위치
  • WORKDIR : 실행할 디렉터리를 나타냄
  • 배시 셸에서 cd 명령어를 입력하는 것과 같은 기능
• EXPOSE : Dockerfile의 빌드로 생성된 이미지에서 노출할 포트를 설정함
• CMD : 컨테이너가 시작될 때마다 실행할 명령어(커맨드)를 설정하며, Dockerfile에서 한 번만 사용할 수 있음
  • docker run 명령어에서 커맨드 명령줄 인자를 입력하면 Dockerfile에서 사용한 CMD의 명령어는 run의 커맨드로 덮어 쓰임
• ENV : Dockerfile에서 사용될 환경변수를 지정
  • 설정한 환경변수는 ${ENV_NAME} 또는 $ENV_NAME의 형태로 사용
  • 이미지에도 저장됨
  • run 명령어에서 -e 옵션을 사용해 같은 이름의 환경변수를 사용하면 기존의 값은 덮어쓰여짐
  • 값이 설정되지 않은 경우와 값이 설정된 경우를 구분해 사용할 수 있음
    • ${env_name:-vale} : env_name이라는 환경변수의 값이 설정되지 않았으면 이 환경변수의 값을 value로 사용함
    • ${env_name:+vale} : env_name의 값이 설정되어 있으면 value를 값으로 사용하고 값이 설정되지 않았으면 빈 문자열을 사용함
• VOLUME : 빌드된 이미지로 컨테이너를 생성했을 때 호스트와 공유할 컨테이너 내부의 디렉터리를 설정
• ARG : build 명령어를 실행할 때 추가로 입력을 받아 Dockerfile 내에서 사용될 변수의 값을 설정함
  • 기본값을 지정할 수도 있음
  • build 명령어를 실행할 때 --build-arg 옵션을 사용해 Dockerfile의 ARG에 값을 입력
• USER : 컨테이너 내에서 사용될 사용자 계정의 이름이나 UID를 설정하면 그 아래의 명령어는 해당 사용자 권한으로 실행됨
  • 루트 권한이 필요하지 않다면 USER를 사용하는 것을 권장함
• ONBUILD : 빌드된 이미지를 기반으로 하는 다른 이미지가 Dockerfile로 생성될 때 실행할 명령어를 추가
  • 부모 이미지의 자식 이미지에만 적용되며 자식 이미지는 ONBUILD 속성을 상속받지 않음
  • 이미지가 빌드하거나 활용할 소스코드를 ONBUILD ADD로 추가해 좀 더 깔끔하게 Dockerfile을 사용할 수 있음
• STOPSIGNAL : 컨테이너가 정지될 때 사용도리 시스템 콜의 종류를 지정
  • 기본은 SIGTERM
  • docker run 명령어의 --stop-signal 옵션으로 컨테이너에 개별적으로 설정할 수 있음
• HEALTHCHECK : 이미지로부터 생성된 컨테이너에서 동작하는 애플리케이션의 상태를 체크하도록 설정
  • 컨테이너 내부에서 동작 중인 애플리케이션의 프로세스가 종료되지는 않았으나 애플리케이션이 동작하고 있지 않은 상태를 방지하기 위해 사용
  • --interval : 컨테이너의 상태를 체크하는 주기
  • --timeout : 여기에 설정된 시간을 초과하면 상태 체크에 실패한 것으로 간주
  • --retries : 여기에 설정된 횟수만큼 상태 체크에 실패하면 해당 컨테이너는 unhealthy 상태로 설정됨
• SHELL : 사용하려는 셸을 명시적으로 지정
  • 리눅스 기본은 "/bin/sh -c", 윈도우는 "cmd /S /C"
• COPY : 로컬 디렉터리에서 읽어 들인 컨텍스트로부터 이미지에 파일을 복사하는 역할
•  ADD : 로컬 파일, 외부 URL 및 tar 파일에서도 파일을 추가할 수 있음
  • tar 파일은 자동으로 해제해서 추가함
  • ADD로 URL이나 tar 파일을 추가할 경우 이미지에 정확히 어떤 파일이 추가될지 알 수 없기 때문에 권장하지 않음
• ENTRYPOINT, CMD
  • CMD : 컨테이너가 시작될 때 수행할 명령을 지정
  • ENTRYPOINT : 컨테이너가 시작될 때 수행할 명령을 지정
    • 커맨드를 인자로 받아 사용할 수 있는 스크립트의 역할을 수행
  • 컨테이너에 entrypoint가 설정되면 run 명령어의 맨 마지막에 입력된 cmd를 인자로 삼아 명령어를 출력함
  • entrypoint가 설정되지 않았다면 cmd에 설정된 명령어를 그대로 실행하지만 entrypoint가 설정됐다면 cmd는 단지 entrypoint에 대한 인자의 기능을 함
  • entrypoint를 이용한 스크립트 실행
    • 일반적으로는 스크립트 파일을 entrypoint의 인자로 사용해 컨테이너가 시작될 때마다 해당 스크립트 파일을 실행하도록 설정함
    • 스크립트 파일의 이름을 entrypoint의 인자로 입력함
    • 실행할 스크립트 파일은 컨테이너 내부에 존재해야 함(이미지 내에 스크립트 파일이 존재해야함)
    • 이미지를 빌드할 때 이미지가 작동하는 단계
      • 1. 어떤 설정 및 실행이 필요한지에 대해 스크립트로 정리
      • 2. ADD 또는 COPY로 스크립트를 이미지로 복사
      • 3. ENTRYPOINT를 이 스크립트로 설정
      • 4. 이미지를 빌드해 사용
      • 5. 스크립트에서 필요한 인자는 docker run 명령어에서 cmd로 entrypoint의 스크립트에 전달
  • JSON 배열 형태와 일반 형식의 차이점
    • JSON 배열 형태가 아닌 CMD와 ENTRYPOINT를 사용하면 실제로 이미지를 생성할 때 cmd와 entrypoint에 /bin/sh -c가 앞에 추가됨
    • JSON 배열 형태로 명령어를 입력하면 입력된 명령어가 그대로 이미지에서 사용됨

 

• 빌드는 docker build 명령어로 실행한다
• 이미지 빌드 중 오류가 발생하면 build 명령어는 중지되고 이미지 레이어 생성을 위해 마지막으로 생성된 임시 컨테이너가 삭제되지 않은 채로 남게 됨(<none>:<none>)