docker build를 실행하면, Docker는 빌드 컨텍스트(빌드 디렉터리의 파일들)를 데몬으로 보냅니다. .dockerignore 파일은 이 컨텍스트에서 불필요한 파일을 제외합니다 — 빌드 속도를 높이고, image 크기를 줄이며, 민감한 파일의 누출을 방지합니다.
docker build -t myapp . # "."가 빌드 컨텍스트 — 데몬으로 보내지는 디렉터리
# → Docker는 빌드 전에 전체 컨텍스트 디렉터리를 tarball로 만들어 데몬으로 보냄
# → 큰 컨텍스트(node_modules, .git, 큰 파일) = 느린 빌드, 더 많은 데이터 전송
빌드 컨텍스트는 image를 빌드하기 위해 Docker가 데몬으로 보내는 파일 집합입니다. 제외되지 않는 한 빌드 디렉터리의 모든 것이 포함됩니다 — 그래서 비대한 컨텍스트는 모든 빌드를 느리게 만듭니다.
# .dockerignore (.gitignore와 비슷하지만, 빌드 컨텍스트용)
node_modules # 로컬 의존성을 보내지 않음(어차피 image에서 설치됨)
.git # 버전 히스토리를 보내지 않음
*.log
.env # ⚠️ SECRET을 빌드 컨텍스트/image로 보내지 않음
Dockerfile
dist
.vscode
.dockerignore는 .gitignore처럼 작동하여 빌드 컨텍스트에서 파일을 제외합니다.
✓ 더 빠른 빌드 — 더 작은 컨텍스트가 더 빨리 전송됨; 처리할 파일 적음
(캐싱에도 도움: COPY . . 가 무관한 파일 변경으로 무효화되지 않음)
✓ 더 작은 image — 제외된 파일(node_modules, .git)이 image로 COPY되지 않음
✓ 보안 — SECRET(.env, 키, 자격 증명)을 컨텍스트와 image 밖에 유지
(그렇지 않으면 COPY . . 가 .env 파일을 image로 복사할 수 있음 — 실제 누출 위험)
빌드 컨텍스트와 .dockerignore를 이해하는 것은 효율적이고 안전한 Docker 빌드에 가치가 있으므로, 실질적으로 유용한 지식입니다.
많은 개발자가 docker build .이 빌드 전에 전체 빌드 컨텍스트 디렉터리를 데몬으로 보낸다는 것을 깨닫지 못합니다 — 그래서 비대한 컨텍스트(node_modules, .git, 빌드 산출물, 큰 파일을 포함하는)는 모든 빌드를 느리게 만들고(전송하고 처리할 데이터가 더 많음) 원치 않는 파일을 image로 복사할 위험이 있습니다.
.dockerignore 파일(.gitignore처럼 작동)은 세 가지 구체적인 이점으로 이를 다룹니다. 더 빠른 빌드(더 작은 컨텍스트가 더 빨리 전송되고 처리되며, COPY . .이 무관한 파일 변경으로 무효화되지 않으므로 layer 캐싱도 개선), 더 작은 image(제외된 파일이 복사되지 않음 — 예: 어차피 재설치되는 로컬 node_modules를 번들하지 않음), 그리고 결정적으로 보안(.env 파일, 키, 자격 증명 같은 secret을 빌드 컨텍스트와 image 밖에 유지 — COPY . .이 그렇지 않으면 .env를 image로 복사할 수 있으므로, 실제적이고 흔한 자격 증명 누출 위험).
이 보안 이점은 특히 중요합니다. 지나치게 광범위한 복사를 통해 실수로 secret이나 민감한 파일을 image에 굽는 것은 .dockerignore가 방지하는 데 도움이 되는 진짜 실수이기 때문입니다.
빌드는 끊임없이 발생하고 빌드 효율성, image 크기, secret 누출 방지가 모두 중요하며, 빌드 컨텍스트를 이해하고 .dockerignore를 사용하는 것이 이 세 가지 모두를 직접 개선하므로, 빌드 컨텍스트와 .dockerignore를 이해하는 것은 가치 있고 실질적으로 관련된 Docker 지식입니다 — 빠르고, 가볍고, 안전한 빌드를 위한 간단하지만 중요한 관행으로, 간과하기 쉽지만 의미 있게 영향력이 있으며, 특히 image에 secret이 실수로 포함되는 것을 방지하는 데 그렇습니다.