나만의 도커 레시피: Dockerfile 이해하기

Dockerfile이란 무엇인가?

Dockerfile은 확장자가 없는 단순한 텍스트 파일입니다. (파일 이름이 정확히 `Dockerfile`이어야 합니다.) 이 파일 안에는 위에서부터 아래로 한 줄씩, 도커 엔진이 순서대로 실행해야 할 명령들이 적혀 있습니다.

이미지를 만드는 레시피

요리를 할 때 "1. 냄비에 물을 붓는다. 2. 라면을 넣는다. 3. 3분간 끓인다."와 같은 순서가 있듯이, Dockerfile에도 "1. 리눅스 환경을 준비한다. 2. 파이썬을 설치한다. 3. 내 소스 코드를 복사한다. 4. 프로그램을 실행한다."라는 순서가 기록됩니다. 도커는 이 파일에 적힌 레시피를 그대로 따라 하면서 차곡차곡 이미지를 만들어냅니다.

자동화된 설치 스크립트

과거에는 서버 관리자가 밤을 새워가며 명령어들을 직접 타이핑해서 서버 환경을 세팅했습니다. Dockerfile은 인간이 치던 그 명령어들을 문서에 기록해 둔 자동화 스크립트입니다. 문서로 남겨져 있기 때문에 실수할 일이 없고, 다른 사람과 코드로 공유하기도 매우 쉽습니다.

Dockerfile의 핵심 명령어들

Dockerfile에서 사용하는 명령어는 모두 대문자로 쓰는 것이 관례입니다. 가장 자주 쓰이는 5가지 핵심 명령어를 살펴보겠습니다.

FROM ubuntu:22.04

WORKDIR /app

COPY . /app

RUN apt-get update && apt-get install -y python3

CMD ["python3", "app.py"]

FROM: 어떤 베이스를 사용할 것인가

`FROM`은 마치 도화지를 고르는 것과 같습니다. 완전히 빈 공간에서 모든 것을 스스로 설치하는 것은 너무 어렵습니다. 그래서 누군가 미리 만들어둔 기본 이미지를 가져와서 그 위에서 작업을 시작합니다. 예를 들어 `FROM node:20`이라고 적으면, 이미 리눅스 운영체제와 Node.js 20버전이 완벽하게 세팅된 상태에서 출발하겠다는 뜻입니다. 바이브코딩을 할 때는 대부분 프레임워크에 맞는 공식 베이스 이미지를 가져다 씁니다.

WORKDIR: 작업 디렉토리 설정

`WORKDIR`은 도커 컨테이너 안에서 내가 코드를 놔둘 기준 폴더를 만드는 명령어입니다. `WORKDIR /app`이라고 적으면, 도커 내부에 `/app`이라는 방을 만들고, 앞으로 복사하는 파일이나 실행하는 명령어는 모두 이 방 안에서 이루어지도록 설정합니다. 폴더 구조를 깔끔하게 유지하기 위해 필수적입니다.

COPY: 내 파일들을 도커로 복사하기

`COPY`는 내 컴퓨터에 있는 소스 코드 파일들을 도커 이미지 내부로 집어넣는 명령어입니다. `COPY . .` 이라는 명령어를 자주 보게 될 텐데, 이는 "내 컴퓨터의 현재 폴더(`.`)에 있는 모든 것을 도커 내부의 현재 폴더(`.`)로 복사해라"라는 의미입니다.

RUN과 CMD: 명령어 실행의 차이

초보자가 가장 많이 헷갈리는 것이 `RUN`과 `CMD`의 차이입니다.

• `RUN`: 붕어빵 틀(이미지)을 만드는 과정(Build)에서 실행됩니다. 주로 패키지나 라이브러리를 다운로드하고 설치할 때 씁니다. (예: `npm install`)
• `CMD`: 붕어빵(컨테이너)이 완성되어 구워져 나왔을 때(Run), 즉 컨테이너가 켜지자마자 실행될 기본 프로그램입니다. (예: `npm start`) 이미지 빌드 때는 실행되지 않고 기다립니다.

# 1. Node.js 20버전이 설치된 기본 환경을 가져옵니다.
FROM node:20

# 2. 도커 내부에 /app 이라는 폴더를 만들고 그곳으로 이동합니다.
WORKDIR /app

# 3. 프로젝트의 패키지 정보 파일을 먼저 복사합니다.
COPY package.json .

# 4. 이미지 빌드 과정에서 필요한 라이브러리들을 설치합니다. (RUN)
RUN npm install

# 5. 나머지 내 소스 코드 전부를 /app 폴더 안으로 복사합니다.
COPY . .

# 6. 이 이미지로 컨테이너를 실행할 때, 서버를 켜는 명령을 지정합니다. (CMD)
CMD ["npm", "start"]

Dockerfile 작성 시 주의할 점

AI가 Dockerfile을 알아서 짜주더라도, 레시피가 어떻게 돌아가는지 눈으로 읽을 수 있으면 문제를 해결하기 훨씬 쉬워집니다.