...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: process "/bin/sh -c npm instal" did not complete successfully: exit code: 1

Pe scurt

Comanda dintr-un RUN a eșuat în timpul build-ului (codul 1). Motivul real e în liniile de deasupra mesajului, în blocul > [3/3] RUN ...: o comandă scrisă greșit, un pachet inexistent, apt-get install fără apt-get update sau un fișier necopiat încă.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare RUN rulează o comandă de shell (/bin/sh -c "…") într-un container temporar. Dacă acea comandă iese cu un cod diferit de 0, build-ul se oprește, iar BuildKit afișează mesajul de la final, cu comanda exactă și codul ei.

Mesajul final spune doar *că* a eșuat. De ce a eșuat apare mai sus, în blocul care începe cu > [3/3] RUN npm instal:, unde vezi ieșirea comenzii (fiecare linie cu timpul în față, de exemplu 0.400 npm <command>). Acolo găsești eroarea reală: comandă necunoscută, E: Unable to locate package, npm ERR! 404, ERROR: Could not find a version that satisfies the requirement, not found.

Codul ajută și el: 1 = eroare generică, 127 = comanda nu există în imagine (de exemplu curl în imagini slim), 100 = eroare apt.

De ce apare: cauzele frecvente

1Comandă scrisă greșit

Greșit
BASH
RUN npm instal
Corect
BASH
RUN npm install

npm nu are subcomanda instal, afișează lista de comenzi și iese cu 1. Cu npm install, dependențele se instalează.

2apt-get install fără apt-get update

Greșit
BASH
FROM debian:bookworm-slim
RUN apt-get install -y curl
Corect
BASH
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y curl \
    && rm -rf /var/lib/apt/lists/*

Imaginile de bază nu au listele de pachete, deci apt nu găsește curl (Unable to locate package). update descarcă listele în același strat.

3Fișierul de dependențe nu e copiat înainte de RUN

Greșit
BASH
WORKDIR /app
RUN pip install -r requirements.txt
COPY . .
Corect
BASH
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .

La momentul RUN, requirements.txt nu există încă în imagine. Ordinea instrucțiunilor contează.

4Unealta nu există în imagine (exit code: 127)

Greșit
BASH
FROM python:3.12-slim
RUN curl -O https://exemplu.ro/date.csv
Corect
BASH
FROM python:3.12-slim
RUN python -c "import urllib.request as u; u.urlretrieve('https://exemplu.ro/date.csv', 'date.csv')"

Imaginile slim nu au curl; shell-ul întoarce 127. Instalezi unealta sau folosești ce are deja imaginea.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin-api, docker build -t magazin-api:1.0 . eșuează cu process "/bin/sh -c npm instal" did not complete successfully: exit code: 1. Citește ieșirea pasului care a eșuat, repară comanda din RUN și construiește imaginea magazin-api:1.0.

Indiciu

Ieșirea pasului arată lista de comenzi npm: subcomanda corectă pentru instalarea dependențelor e install.

Alte forme ale mesajului

  • ERROR: failed to solve: process "/bin/sh -c apt-get install -y curl" did not complete successfully: exit code: 100
  • ERROR: failed to solve: process "/bin/sh -c curl -O https://exemplu.ro/date.csv" did not complete successfully: exit code: 127
  • The command '/bin/sh -c npm install' returned a non-zero code: 1

Cum o eviți pe viitor

  • Testează comenzile într-un container din aceeași imagine de bază înainte să le pui în RUN: docker run --rm -it node:20-alpine sh.
  • Copiază fișierele de dependențe înaintea comenzilor care le folosesc.
  • Pe Debian/Ubuntu, scrie mereu apt-get update && apt-get install -y … în același RUN.
  • Când eșuează, rulează docker build --progress=plain . ca să vezi toată ieșirea comenzii, nu doar ultimele linii.

Întrebări frecvente

Unde văd eroarea completă?

În blocul dintre liniile ------ de deasupra mesajului final. Dacă e trunchiată, rulează din nou cu --progress=plain, care afișează toată ieșirea fiecărui pas.

Pe calculatorul meu comanda merge. De ce nu și în build?

Pentru că rulează în imaginea de bază, nu pe calculatorul tău: alt sistem (Alpine sau Debian), alte unelte instalate, fără fișierele pe care nu le-ai copiat încă și fără variabilele tale de mediu.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.