[Docker] 처음 배우는 Dockerfile: FROM부터 EXPOSE까지 쉽게 정리해보기

Dockerfile이란?!

Docker 이미지들을 누군가 만들어서 Dockerhub에 올려놓고, 그걸 다운받아서 사용할 수 있다.
그렇다면 Docker 이미지는 어떻게 만드는걸까?

Dockerfile이라는 것을 활용해서 Docker 이미지를 만들 수 있다.

정리하자면, Dockerfile이란 Docker 이미지를 만들게 해주는 파일이다.

 

FROM : 베이스 이미지 생성

FROM은 베이스 이미지를 생성하는 역할을 한다. Docker 컨테이너를 특정 초기 이미지를 기반으로 추가적인 세팅을 할 수 있다.
여기서 말하는 '특정 초기 이미지'가 곧 베이스 이미지이다.

컨테이너를 새로 띄워서 미니 컴퓨터 환경을 구축할 때 기본 프로그램이 어떤 게 깔려있으면 좋겠는지 선택하는 옵션이라고 생각하면 된다.

# 문법
FROM [이미지명]
FROM [이미지명]:[태그명]

👉  태그명을 적지 않으면 해당 이미지의 최신(latest) 버전을 사용한다.

실습

1. Dockerfile 만들기

# JDK 17
FROM openjdk:17-jdk

2. Dockerfile을 기반으로 이미지 만들기

$ docker build -t my-jdk17-server .

3. 이미지를 기반으로 컨테이너 띄우기

$ docker run -d my-jdk17-server

4. 컨테이너 조회하기

$ docker ps # 실행되고 있는 컨테이너가 없다.
$ docker ps -a # 확인해보니 컨테이너가 종료되어 있다.

5. 컨테이너 내부로 들어가서 jdk가 잘 깔렸는지 확인하기

FROM openjdk:17-jdk

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"]

$ docker build -t my-jdk17-server . # 이미지 빌드
$ docker run -d my-jdk17-server # 컨테이너 실행
$ docker ps # 실행 중인 컨테이너 조회
$ docker exec -it [컨테이너 ID] bash # 컨테이너 접속

$ java -version # JDK 설치되어 있는 지 확인

 

종료된 컨테이너에 들어가서 디버깅하고 싶을 때

프로그래밍을 할 때 중간중간 잘 작동하는지 확인하는 습관은 굉장히 중요하다. 어떤 명령어를 입력하고 난 뒤에 명령어가 정상적으로 수행됐는지 어떻게 확인할 수 있는지 방법을 찾아봐야 한다.
이 습관이 몸에 익으면 어떤 명령어를 수행하더라도 그 명령어가 어떻게 작동하는지 파헤칠 수 있게 된다.
또한 어떤 명령어를 실행시킨 뒤에 에러가 생기더라도 금방 발견할 수 있어 디버깅도 훨씬 수월하다.

👉  docker logs를 활용해 컨테이너 로그 확인하기
👉  docker exec -it를 활용해 컨테이너 내부에 직접 들어가 보기

위의 방법 중 docker exec -it은 실행 중인 컨테이너에만 쓸 수 있는 명령어이다.
하지만 이미지를 만들면서 컨테이너를 실행시켜 보면, 컨테이너의 특성상 명령어 처리가 다 끝나는 대로 컨테이너가 종료된다.
그러다 보니 내부적으로 어떻게 컨테이너가 형성됐는지 디버깅을 하는데 어려움을 겪는다.

그렇다면 어떻게 해야 할까?

FROM openjdk:17-jdk

...

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"] # 500초 동안 시스템을 일시정지 시키는 명령어

👉 컨테이너가 바로 종료되는 것을 막을 수 있다. 그런 뒤에 docker exec -it를 활용해 컨테이너 내부에 직접 들어가서 디버깅을 하면 된다.

 

COPY : 파일 복사(이동)

COPY는 호스트 컴퓨터에 있는 파일을 복사해서 컨테이너로 전달한다.

# 문법
COPY [호스트 컴퓨터에 있는 복사할 파일의 경로] [컨테이너에서 파일이 위치할 경로]

# 예시
COPY app.txt /app.txt

파일 복사해 보기

1. app.txt 파일 만들기

2. Dockerfile 만들어서 이미지 생성 및 컨테이너 실행

FROM ubuntu

COPY app.txt /app.txt

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"] # 디버깅용 코드

$ docker build -t my-server .
$ docker run -d my-server
$ docker exec -it [Container ID] bash

$ ls

폴터 안에 있는 모든 파일 복사

1. my-app 디렉토리 만들기, my-app 디텍토리 안에 파일 만들기

2. Dockerfile 만들어서 이미지 생성 및 컨테이너 실행

FROM ubuntu

COPY my-app /my-app/

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"] # 디버깅용 코드

$ docker build -t my-server .
$ docker run -d my-server
$ docker exec -it [Container ID] bash

$ ls

와일드카드 사용해 보기

1. app.txt, readme.txt 파일 2개 만들기

2. Dockerfile 만들어서 이미지 생성 및 컨테이너 실행

FROM ubuntu

COPY *.txt /text-files/

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"] # 디버깅용 코드

👉  /text-files라고 적으면 안 되고 /text-files/라고 적어야 text-files라는 디렉토리 안에 파일들이 정상적으로 복사된다.

$ docker build -t my-server .
$ docker run -d my-server
$ docker exec -it [Container ID] bash

$ ls

.dockerignore 사용해 보기

특정 파일 또는 폴더만 COPY를 하고 싶지 않을 수 있다. 그럴 때 .dockerignore를 활용한다.

1. .dockerignore 파일 만들기

readme.txt

2. Dockerfile 만들어서 이미지 생성 및 컨테이너 실행

FROM ubuntu

COPY ./ /

ENTRYPOINT ["/bin/bash", "-c", "sleep 500"] # 디버깅용 코드

$ docker build -t my-server .
$ docker run -d my-server
$ docker exec -it [Container ID] bash

$ ls

 

ENTRYPOINT : 컨테이너가 시작할 때 실행되는 명령어

ENTRYPOINT는 컨테이너가 생성되고 최초로 실행할 때 수행되는 명령어를 뜻한다.
ENTRYPOINT에는 미니 컴퓨터의 전원을 켜고 나서 실행시키고 싶은 명령어를 적으면 된다.

FROM ubuntu

ENTRYPOINT ["/bin/bash", "-c", "echo hello"]

$ docker build -t my-server .
$ docker run -d my-server
$ docker ps -a
$ docker logs [Container ID]

 

RUN : 이미지를 생성하는 과정에서 사용할 명령문 실행

RUN은 이미지 생성 과정에서 명령어를 실행시켜야 할 때 사용한다.

# 문법
RUN [명령문]

# 예시
RUN npm install

RUN vs ENTRYPOINT

RUN은 '이미지 생성 과정'에서 필요한 명령어를 실행시킬 때 사용하고,
ENTRYPOINT는 생성된 이미지를 기반으로 컨테이너를 생성한 직후에 명령어를 실행시킬 때 사용한다.

 

WORKDIR : 작업 디렉토리를 지정

WORKDIR으로 작업 디렉토리를 전환하면 그 이후에 등장하는 모든 RUN, CMD, ENTRYPOINT, COPY, ADD 명령문은 해당 디렉토리를 기준으로 실행된다. 작업 디렉토리를 굳이 지정해 주는 이유는 컨테이너 내부의 폴더를 깔끔하게 관리하기 위해서이다.
컨테이너도 Dockerfile을 통해 생성되는 파일들을 특정 폴더에 정리해 두는 것이 추후에 관리가 쉽다.
만약 WORKDIR을 쓰지 않으면 컨테이너 내부에 존재하는 기존 파일들과 뒤섞여버린다.

# 문법
WORKDIR [작업 디렉토리로 사용할 절대 경로]

# 예시
WORKDIR /usr/src/app

 

EXPOSE : 컨테이너 내부에서 사용 중인 포트를 문서화하기

EXPOSE는 컨테이너 내부에서 어떤 포트에 프로그램이 실행되는 지를 문서화하는 역할만 한다.
쉽게 얘기하면 EXPOSE 명령어는 쓰나 안 쓰나 작동하는 방식에는 영향을 미치지 않는다.

# 문법
EXPOSE [포트 번호]

# 예시
EXPOSE 3000