DockerFile 이란?

Docker 상에서 작동시킬 컨테이너의 구성 정보를 기술한 파일
Docker build 명령을 통해 Docker file 에 기술된 구성 정보를 바탕으로 Docker image를 생성한다.

DockerFile의 기본 구문

• FROM : 베이스 이미지 지정
• VOLUME : 볼륨 마운트
• RUN : 명령 실행
• USER : 사용자 지정
• CMD : 컨테이너 실행 명령 (오버라이딩 가능)
• ENTRYPOINT : CMD 보다 먼저 실행되는 컨테이너 실행 명령 (오버라이딩 불가)
  WORKDIR : 작업 디렉토리
• EXPOSE : 포트 익스포트
• ONBUILD : 빌드 완료 후 실행되는 명령

DockerFile을 이용한 이미지 빌드

# 기본
docker build -t my_ubuntu:1.0 .
# 도커파일의 이름이 Dockerfile이 아닌 경우, 직접 -f 옵션을 통해 써줘야한다.
docker build -t my_ubuntu:2.0 -f ./new_dockerfile .

-t : 이미지에 태그를 붙이는 옵션.

• my_ubuntu:1.0은 my_ubuntu라는 이미지에 1.0이라는 태그를 붙이는 것을 의미한다.

-f : Dockerfile의 경로와 파일명을 지정하는 옵션.

• 기본적으로 Docker는 현재 디렉토리에 있는 Dockerfile을 사용하여 이미지를 빌드한다.
  만약 Dockerfile의 이름이 다른 경우에는 -f 옵션을 사용하여 명시적으로 -f ./new_dockerfile와 같이 경로를 지정해 주어야 한다.

. : 현재 디렉토리를 나타내는 기호.

• Dockerfile이 현재 디렉토리에 위치해 있을 때, .을 사용하여 현재 디렉토리에 있는 Dockerfile을 빌드한다.
  이러한 디렉토리를 "빌드 컨텍스트(build context)"라고 한다.

---

RUN

RUN [실행하고 싶은 명령]

RUN은 실제 이미지 빌드 과정에서 실행되는 명령어이다.
이는 컨테이너가 아닌 이미지를 생성할 때 포함되는 명령어로 이미지 생성에 관여한다.

주로 패키지 설치, 소프트웨어 설치, 설정 변경 등과 같이 이미지 빌드 시 필요한 명령어를 실행하는 데 사용된다.

RUN 명령어의 기술 방식

RUN 명령을 기술하는 방식은 두 가지가 존재하며 shell 형식으로 기술하는 방식과 Exec 형식으로 기술하는 방식이 있다.

CMD

CMD [실행하고 싶은 명령]

CMD 명령어는 이미지가 로드가 되어 컨테이너가 실행될 때 동작한다.
컨테이너 실행시의 docker run 명령어 맨 끝에 오는 CMD 명령어를 덮어씌운다.

CMD 명령어는 컨테이너 실행 시 디폴트로 실행되는 명령어로, 보통 애플리케이션의 주 프로세스를 실행하는 역할을 한다.

🧐 RUN과의 차이?

•RUN은 이미지 생성에 필요한 명령을 기술하지만, CMD는 이미지를 바탕으로 생성된 컨테이너 에서의 명령을 실행하기 위해 사용된다.

⚠️ Dockerfile 에는 하나의 CMD 명령을 기술할 수 있고, 만일 여러 개를 지정하면 마지막 명령만 유효하다.

ENTRYPOINT

CMD 명령어를 인자로 받는 고정된 명령어. CMD와 다르게 강제성을 가진다.

즉, CMD는 ENTRYPOINT에 지정된 실행 명령어의 옵션 및 인자를 오버라이딩 하는데 사용된다.

ENTRYPOINT 기술 방법

• Exec 형식으로 기술
  ENTRYPOINT [“nginx”, “-g”, “daemon off;”]

• Shell 형식으로 기술
  ENTRYPOINT nginx –g “daemon off;”

ENTRYPOINT 예제

• 이미지 빌드
  • top 명령어를 사용하여 시스템의 프로세스를 모니터링
    -d 10 옵션을 함께 사용하여 갱신 주기를 10초로 설정
    
• 이미지 빌드 결과
  

• 컨테이너 생성
  ENTRYPOINT가 고정된 상태로 CMD 커멘드를 각각 수정하며 컨테이너 생성해보자.
  CMD 부분의 값을 변경해가며 run 명령어를 통해서 entry_sample:1.0 이미지의 컨테이너를 생성할 수 있다.
  

환경 변수

도커 파일

# 도커파일
FROM ubuntu:latest
ENV vinca=0121
# 한번 출력하고 종료
CMD echo ${vinca}
또는
# 5초마다 출력
CMD ["bash", "-c", "while true; do echo ${vinca}; sleep 5; done"]

실행 명령어

bin/bash와 같이 뒤에 명령어를 따로 지정하는 경우, 도커 이미지로 정의한 CMD 명령어는 무시되고 /bin/bash가 실행된다.

# bash 쉘을 실행할 경우 즉시 종료되지 않음 
docker run -it --name=my_container my_image:1.0 /bin/bash
# bash 쉘을 지정하지 않을 경우 "CMD echo ${vinca}" 부분이 실행되고 종료됨
docker run -it --name=my_container my_image:1.0

헬스체크

FROM ubuntu:latest

# apt 업데이트 명령어를 실행하여 초기 준비 작업 수행
RUN apt update -y

# 컨테이너에서 실행될 명령어 설정 (예: 간단한 웹 서버 실행)
CMD ["python3", "-m", "http.server", "8080"]

# exec 형식의 헬스 체크 정의
HEALTHCHECK --interval=30s --timeout=3s \
  CMD [ "wget", "-q", "http://localhost:8080" ] || exit 1

docker compose에서의 헬스체크

소스코드

결과