🐋 .dockerignore 생성 | 전송 용량 줄이기

빌드 컨텍스트에 있는 경로와 크기 — 한 줄에 "경로,크기(MB)"

패턴 프리셋 (관행으로 쓰이는 목록이며 규격이 아닙니다)

.dockerignore 패턴 — 한 줄에 하나, ! 로 예외

제외 전 컨텍스트-

제외 후 컨텍스트-

줄어드는 용량-

절감률 (소수 1자리)-

경로	크기	상태	적용된 줄

생성된 .dockerignore

비교 항목	.dockerignore	.gitignore
매칭 엔진	Go filepath.Match 규칙 + ** 확장	git 자체 패턴 규칙
패턴 기준 위치	항상 빌드 컨텍스트 루트	슬래시가 없으면 모든 깊이에서 매칭
하위 깊이 매칭	**/foo 처럼 명시해야 깊은 경로까지 매칭	foo 만 써도 하위 디렉터리까지 매칭
디렉터리 전용 표기	끝 슬래시로 구분하지 않음	foo/ 는 디렉터리만 매칭
! 예외	마지막으로 매칭된 줄이 결정	제외된 디렉터리 안의 파일은 되살릴 수 없음

무엇을 빼면 빌드 컨텍스트가 얼마나 줄어드나

docker build 는 컨텍스트 안의 파일을 먼저 빌더로 전송합니다. 경로별 용량과 제외 패턴을 넣으면 어떤 경로가 전송에서 빠지고 남는 컨텍스트가 몇 MB 가 되는지, 절감률이 몇 퍼센트인지 계산하고 붙여 쓸 .dockerignore 내용을 함께 만듭니다. 판정은 가장 구체적인 경로에 마지막으로 매칭된 줄을 따릅니다.

.gitignore 를 그대로 복사하면 어긋납니다. .dockerignore 는 Go 의 filepath.Match 규칙을 쓰고 패턴을 항상 컨텍스트 루트 기준으로 보기 때문에, 깊은 경로까지 잡으려면 별 두 개를 직접 써야 합니다. 디렉터리 전용 표기도 없습니다. 차이는 아래 비교 표에 정리했습니다(Docker 공식 문서 기준, 2026년 10월 확인).

용량은 입력한 값을 그대로 합산한 추정입니다. 전송 중 압축, 캐시 재사용, 심볼릭 링크는 반영하지 않으므로 실제 전송량과 다를 수 있습니다. 프리셋 목록은 널리 쓰이는 관행이고 공인 규격이 아니니, 빌드에 필요한 파일이 섞여 있지 않은지 직접 확인하세요.

자주 묻는 질문

.gitignore 를 그대로 복사해도 되나요?

문법이 달라 권하지 않습니다. .dockerignore 는 패턴을 항상 컨텍스트 루트 기준으로 읽고 디렉터리 전용 표기가 없어서, .gitignore 에서 모든 깊이를 잡던 패턴이 최상위 한 단계만 잡는 일이 생깁니다.

제외했는데 빌드가 깨지면 어떻게 하나요?

COPY 나 ADD 가 가져가야 하는 파일을 함께 뺀 경우가 많습니다. 표에서 상태가 제외로 바뀐 경로를 보고, 빌드에 필요한 경로라면 느낌표로 시작하는 예외 줄을 뒤쪽에 추가하세요. 마지막으로 매칭된 줄이 결정합니다.

계산된 용량이 실제 전송량과 같나요?

같지 않습니다. 입력한 MB 값을 더한 추정치이며 압축과 캐시 재사용, 심볼릭 링크는 반영하지 않습니다. 줄어드는 비중을 가늠하는 용도로 보시고 정확한 값은 빌드 로그에서 확인하세요.

🐋.dockerignore 생성기

관련된 도구

도커 이미지 최적화 점수

컨테이너 메모리 리밋 설정 가이드

무엇을 빼면 빌드 컨텍스트가 얼마나 줄어드나

자주 묻는 질문

관련된 도구

도커 이미지 최적화 점수

컨테이너 메모리 리밋 설정 가이드

무엇을 빼면 빌드 컨텍스트가 얼마나 줄어드나

자주 묻는 질문

같은 카테고리 도구