docker · Docker
오류 문구
COPY failed: file not found in build context or excluded by .dockerignore
무슨 뜻인가
COPY는 빌드 컨텍스트 안의 것만 가져올 수 있는데 그 자리에 그 파일이 없다는 뜻입니다. docker build 뒤의 마지막 인자가 컨텍스트이므로, 상위 폴더의 파일을 ../x로 가리키거나 .dockerignore가 그 파일을 걸러 낸 경우가 대부분입니다 — node_modules나 *.env를 걸러 두고 정작 그 안의 파일을 COPY하려 할 때 그렇습니다. 문구가 두 원인을 함께 말하니 cat .dockerignore를 먼저 읽고, 경로는 컨텍스트의 뿌리를 기준으로 다시 적으세요. 컨텍스트를 넓혀 해결하려 하면 그 폴더 전체가 데몬으로 전송되어 빌드가 느려집니다.
고치는 명령
cat .dockerignore- 내는 도구
- docker
- Docker
- 12
docker의 오류는 어느 층에서 났는지를 먼저 갈라야 읽히는데 — 클라이언트가 데몬에 닿지 못한 것, 레지스트리가 거절한 것, 빌드 중에 RUN이 실패한 것, 컨테이너가 뜨자마자 죽은 것이 서로 다른 문제입니다 — 특히 빌드와 실행 단계의 오류는 문구 자체가 이유가 아니라 그 안에서 돌던 명령이 남긴 출력에 이유가 있고, 고치는 명령의 값도 층마다 다릅니다.
오류 문구를 읽는 법
- 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
- 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
- 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
- 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
- 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.
자주 묻는 질문
Q. COPY failed: file not found in build context or excluded by .dockerignore 는 무슨 뜻인가요?
COPY는 빌드 컨텍스트 안의 것만 가져올 수 있는데 그 자리에 그 파일이 없다는 뜻입니다. docker build 뒤의 마지막 인자가 컨텍스트이므로, 상위 폴더의 파일을 ../x로 가리키거나 .dockerignore가 그 파일을 걸러 낸 경우가 대부분입니다 — node_modules나 *.env를 걸러 두고 정작 그 안의 파일을 COPY하려 할 때 그렇습니다. 문구가 두 원인을 함께 말하니 cat .dockerignore를 먼저 읽고, 경로는 컨텍스트의 뿌리를 기준으로 다시 적으세요. 컨텍스트를 넓혀 해결하려 하면 그 폴더 전체가 데몬으로 전송되어 빌드가 느려집니다.
Q. 어떻게 고치나요?
cat .dockerignore — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.
Q. 어느 도구가 내는 오류인가요?
docker입니다. Docker 갈래에 있고, 문구는 12낱말입니다.