buildkit · Docker
오류 문구
failed to solve: process "/bin/sh -c npm ci" did not complete successfully: exit code: 1
무슨 뜻인가
Dockerfile의 그 RUN 줄이 0이 아닌 코드로 끝났다는 뜻입니다. 여기에 적힌 것은 실패한 명령과 종료 코드뿐이고 진짜 이유는 그 위에 흐른 그 명령의 출력에 있는데, BuildKit이 성공한 단계를 접어 두기 때문에 잘 보이지 않습니다. docker build --progress=plain으로 다시 돌리면 모든 단계의 출력이 그대로 펼쳐지고, 캐시된 단계가 옛 오류를 감추고 있다면 --no-cache까지 붙이세요 — 대신 처음부터 다시 빌드하므로 시간이 많이 듭니다. exit code: 1은 이유가 아니라 그 명령이 실패했다는 사실일 뿐입니다.
고치는 명령
docker build --progress=plain --no-cache .- 내는 도구
- buildkit
- Docker
- 12
docker의 오류는 어느 층에서 났는지를 먼저 갈라야 읽히는데 — 클라이언트가 데몬에 닿지 못한 것, 레지스트리가 거절한 것, 빌드 중에 RUN이 실패한 것, 컨테이너가 뜨자마자 죽은 것이 서로 다른 문제입니다 — 특히 빌드와 실행 단계의 오류는 문구 자체가 이유가 아니라 그 안에서 돌던 명령이 남긴 출력에 이유가 있고, 고치는 명령의 값도 층마다 다릅니다.
오류 문구를 읽는 법
- 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
- 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
- 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
- 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
- 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.
자주 묻는 질문
Q. failed to solve: process "/bin/sh -c npm ci" did not complete successfully: exit code: 1 는 무슨 뜻인가요?
Dockerfile의 그 RUN 줄이 0이 아닌 코드로 끝났다는 뜻입니다. 여기에 적힌 것은 실패한 명령과 종료 코드뿐이고 진짜 이유는 그 위에 흐른 그 명령의 출력에 있는데, BuildKit이 성공한 단계를 접어 두기 때문에 잘 보이지 않습니다. docker build --progress=plain으로 다시 돌리면 모든 단계의 출력이 그대로 펼쳐지고, 캐시된 단계가 옛 오류를 감추고 있다면 --no-cache까지 붙이세요 — 대신 처음부터 다시 빌드하므로 시간이 많이 듭니다. exit code: 1은 이유가 아니라 그 명령이 실패했다는 사실일 뿐입니다.
Q. 어떻게 고치나요?
docker build --progress=plain --no-cache . — 실행 전에 위의 설명에서 이 명령이 무엇을 버리는지 확인하세요.
Q. 어느 도구가 내는 오류인가요?
buildkit입니다. Docker 갈래에 있고, 문구는 15낱말입니다.