Dockerfile로 내 웹 페이지 빌드하기 · Docker
실행 중인 컨테이너를 손으로 고치기보다 변경 내용을 이미지로 남겨봅니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
빌드 컨텍스트
docker build의 마지막 경로는 COPY가 읽을 파일의 범위입니다. .dockerignore로 불필요한 파일을 제외하고 인증정보를 이미지에 넣지 않습니다.
빌드 시점과 실행 시점
FROM과 COPY는 이미지 내용을 정합니다. CMD는 컨테이너 시작 시 기본 명령이며 RUN처럼 빌드 중 실행되는 명령과 다릅니다.
태그와 포트
태그는 사람이 붙이는 이름이며 불변 식별자가 아닙니다. -p 127.0.0.1:18081:80은 호스트의 로컬 주소만 컨테이너 80번 포트에 연결합니다.
왜 필요한가요?
같은 Dockerfile로 두 번 빌드했을 때 일부 단계가 CACHED라면 결과를 재사용한 것입니다. 변경이 적은 의존성과 자주 바뀌는 소스를 나누면 빌드 흐름을 이해하기 쉽습니다.
차례대로 이해하기
컨텍스트와 레이어
COPY의 원본은 빌드 컨텍스트 안에서 찾습니다. .dockerignore는 불필요한 파일이 컨텍스트로 전달되는 것을 줄입니다. 이전 단계나 입력이 바뀌면 뒤쪽 캐시 재사용에도 영향을 줍니다.
빌드 결과와 실행 확인
이미지 빌드는 파일과 기본 실행 설정을 준비하는 단계입니다. 컨테이너 실행 시 -p로 호스트 포트를 연결하고 HTTP 응답을 확인해야 실제 제공되는 페이지까지 검증한 것입니다.
직접 실행하며 익혀보세요.
Docker Engine 또는 Docker Desktop(Linux 컨테이너), Compose v2, POSIX 셸과 curl이 필요합니다. 개인 실습 호스트에서 실행하고 study- 접두사의 리소스만 정리하세요. 이미지 다운로드에 네트워크가 필요합니다.
새 임시 디렉터리에 HTML과 Dockerfile을 만들고 study-web:v1 이미지를 빌드하세요. 다른 호스트의 Docker daemon을 사용하면 curl은 그 호스트에서 실행해야 합니다.
study_build_dir=$(mktemp -d)
cd "$study_build_dir"
printf '<h1>Study build v1</h1>
' > index.html
cat > Dockerfile <<'DOCKERFILE'
FROM nginx:stable-alpine
COPY index.html /usr/share/nginx/html/index.html
DOCKERFILE
printf '.git
*.key
' > .dockerignore
docker build -t study-web:v1 .
docker run -d --name study-built-web -p 127.0.0.1:18081:80 study-web:v1
curl --retry 10 --retry-all-errors --retry-delay 1 http://127.0.0.1:18081
docker image inspect study-web:v1 --format '{{.Id}}'이렇게 확인하세요
curl에 Study build v1이 나오고 image inspect에서 이미지 ID를 볼 수 있어야 합니다. index.html을 v2로 바꿔 다시 빌드하면 기존 실행 컨테이너는 자동 교체되지 않습니다. 포트 사용 중 오류는 기존 점유자를 확인하거나 18081을 바꿉니다.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
docker stop study-built-web
docker rm study-built-web
docker image rm study-web:v1응용해보기
웹 파일을 수정했는데 컨테이너에서 이전 내용이 보입니다. 무엇을 다시 해야 할까요?
생각해본 뒤 풀이 보기
새 내용으로 이미지를 빌드하고 새 이미지를 사용하는 컨테이너를 생성합니다. 기존 컨테이너를 단순 재시작하는 것만으로 새 이미지로 교체되지 않습니다. 태그뿐 아니라 실제 이미지 ID도 비교하면 원인을 좁힐 수 있습니다.
잠깐, 이해했는지 확인해볼까요?
Dockerfile의 COPY가 읽는 로컬 파일의 범위를 정하는 것은?
- 컨테이너 이름
- 빌드 컨텍스트
- 컨테이너 로그
- 호스트의 모든 파일
생각해본 뒤 풀이 보기
빌드 컨텍스트
COPY는 빌드 컨텍스트 안의 파일을 사용합니다. 태그나 컨테이너 이름이 파일 접근 범위를 정하지 않습니다.