🗒️ Dockerfile 체크리스트 | 캐시 어디서 깨질까?

해당하는 항목만 체크하세요. 점수나 등급은 내지 않고, 해당·미해당 개수와 캐시 재빌드 레이어 수만 셉니다.

의존성 파일을 소스 코드보다 먼저 COPY 했다

멀티스테이지 빌드로 빌드 도구를 최종 이미지에서 뺐다

USER 로 비루트 사용자를 지정했다

베이스 이미지를 latest 가 아닌 고정 태그나 다이제스트로 적었다

.dockerignore 파일을 뒀다

패키지 설치와 캐시 정리를 같은 RUN 에서 처리했다

COPY . . 대신 필요한 경로만 COPY 했다

비밀값을 ENV·ARG 로 이미지에 남기지 않았다

레이어를 만드는 명령 수 (RUN·COPY·ADD 합계)

개

소스 코드를 COPY 하는 명령이 몇 번째인가

번째

의존성을 설치하는 명령이 몇 번째인가

번째

점수 대신 확인 항목과 레이어 수로 본다

Dockerfile 점검에서 종합 점수를 내려면 항목마다 가중치를 정해야 하는데 그 가중치에는 공인 기준이 없습니다. 그래서 이 도구는 점수와 등급을 내지 않고, 해당·미해당 개수를 세고 아직 해당하지 않는 항목을 이유와 함께 보여 줍니다. 항목은 Docker 공식 문서가 설명하는 동작에서 가져왔습니다.

함께 계산하는 값은 레이어 캐시입니다. 레이어를 만드는 명령이 몇 개이고 소스 COPY 가 몇 번째인지 넣으면, 소스만 바뀔 때 캐시로 재사용되는 레이어와 다시 만드는 레이어를 셉니다. 의존성 설치가 소스 COPY 뒤에 있으면 앞으로 옮겼을 때 재빌드 레이어가 몇 개 줄어드는지 같이 보여 줍니다(2026년 10월 기준).

레이어 수는 명령 위치만으로 센 값입니다. 빌드 시간, 캐시 마운트, 원격 캐시 적중, 멀티스테이지에서 실제로 실행되는 단계는 반영하지 않으므로 실측과 다릅니다. 체크 결과도 Dockerfile 을 읽어 판정한 것이 아니라 직접 체크한 내용의 집계입니다.

자주 묻는 질문

왜 점수를 매기지 않나요?

항목별 가중치를 정하는 공인 기준이 없기 때문입니다. 가중치를 임의로 정하면 숫자는 그럴듯해지지만 근거가 없습니다. 그래서 해당·미해당 개수와 레이어 수처럼 셀 수 있는 값만 보여 줍니다.

의존성 설치를 왜 소스 COPY 앞에 두나요?

레이어 캐시는 앞 단계가 바뀌면 그 뒤를 모두 다시 만듭니다. 설치가 뒤에 있으면 소스 한 줄만 고쳐도 설치를 다시 하지만, 앞에 있으면 의존성 파일이 그대로인 동안 그 레이어가 캐시로 재사용됩니다.

Dockerfile 을 붙여 넣으면 자동으로 봐 주나요?

파일을 읽어 판정하지는 않습니다. 명령 수와 위치만 숫자로 받고 항목은 직접 체크하는 방식입니다. 자동 분석은 문법과 베이스 이미지까지 해석해야 하므로 얕게 만들면 틀린 결론을 냅니다.

🗒️Dockerfile 베스트프랙티스 체크리스트

관련된 도구

도커 이미지 최적화 점수

.dockerignore 생성기

점수 대신 확인 항목과 레이어 수로 본다

자주 묻는 질문

관련된 도구

도커 이미지 최적화 점수

.dockerignore 생성기

점수 대신 확인 항목과 레이어 수로 본다

자주 묻는 질문

같은 카테고리 도구