ERROR: failed to solve: dockerfile parse error on line 3: unknown instruction: COPPY (did you mean copy?)
Pe linia indicată, primul cuvânt nu e o instrucțiune Dockerfile validă: e o greșeală de scriere (COPPY, RUNN) sau o linie care continuă comanda de deasupra fără backslash. Corectează linia 3, după sugestia did you mean.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare linie dintr-un Dockerfile începe cu o instrucțiune: FROM, RUN, COPY, ADD, WORKDIR, ENV, ARG, EXPOSE, USER, CMD, ENTRYPOINT, HEALTHCHECK, LABEL, VOLUME și altele câteva. Parser-ul citește fișierul înainte de orice pas al build-ului și se oprește la primul cuvânt necunoscut, cu numărul liniei și, de obicei, o sugestie (did you mean copy?).
În afară de greșelile de scriere, eroarea apare des la comenzile lungi rupte pe mai multe rânduri: dacă uiți \ la finalul unui rând dintr-un RUN, rândul următor (de exemplu curl \) e citit ca instrucțiune nouă, deci unknown instruction: CURL. Majusculele nu contează (run merge), dar convenția e să le scrii cu litere mari.
Blocul cu >>> de deasupra mesajului arată exact linia problematică.
De ce apare: cauzele frecvente
1Instrucțiune scrisă greșit
FROM nginx:1.27-alpine
COPPY index.html /usr/share/nginx/html/FROM nginx:1.27-alpine
COPY index.html /usr/share/nginx/html/COPPY nu există; parser-ul se oprește la ea. COPY e instrucțiunea corectă.
2Lipsește backslash-ul într-un RUN pe mai multe rânduri
RUN apt-get update && apt-get install -y
curl gitRUN apt-get update && apt-get install -y \
curl gitFără \ la final, rândul al doilea e o instrucțiune nouă, iar CURL nu există.
3Comandă de shell scrisă direct
FROM node:20-alpine
npm installFROM node:20-alpine
RUN npm installComenzile de shell se rulează în Dockerfile doar prin RUN.
Repară eroarea, direct în pagină
În ~/cafenea, build-ul docker build -t cafenea:1.0 . se oprește cu dockerfile parse error on line 3: unknown instruction: COPPY. Repară linia din Dockerfile (în tabul Dockerfile sau cu sed), construiește imaginea cafenea:1.0 și verifică că pagina a ajuns în imagine.
Indiciu
Instrucțiunea care copiază fișiere în imagine se scrie COPY.
Reparația
Corectează instrucțiunea și construiește:
sed -i 's/^COPPY/COPY/' Dockerfile
docker build -t cafenea:1.0 .
docker run --rm cafenea:1.0 cat /usr/share/nginx/html/index.html<h1>Cafeneaua Boabe</h1>De ce merge
Parser-ul Dockerfile cunoaște doar instrucțiunile din documentație, iar COPPY nu e una dintre ele, așa că build-ul se oprește înainte de primul pas. După corectare, linia 3 devine COPY index.html /usr/share/nginx/html/, build-ul trece de parsare, iar pagina ajunge în folderul servit de nginx.
Alte forme ale mesajului
ERROR: failed to solve: dockerfile parse error on line 4: unknown instruction: RUNN (did you mean run?)ERROR: failed to solve: dockerfile parse error on line 5: unknown instruction: CURLError response from daemon: dockerfile parse error line 3: unknown instruction: COPPY
Cum o eviți pe viitor
Scrie Dockerfile-urile într-un editor cu suport pentru Docker (VS Code cu extensia Docker), care subliniază instrucțiunile necunoscute. Rulează hadolint Dockerfile înainte de commit, pentru greșeli și bune practici. La comenzile RUN lungi, pune câte un pachet pe rând și verifică să existe \ la finalul fiecărui rând, mai puțin ultimul.
Întrebări frecvente
Instrucțiunile trebuie scrise cu majuscule?
Nu, copy și COPY sunt la fel pentru parser. Majusculele sunt doar o convenție, ca să se distingă instrucțiunile de argumente.
Build-ul se oprește înainte de orice pas. E normal?
Da. Dockerfile-ul e citit și validat în întregime înainte de primul pas, deci o greșeală de sintaxă oprește build-ul imediat, oricât de jos ar fi.
Erori înrudite
ERROR: failed to solve: process "/bin/sh -c npm instal" did not complete successfully: exit code: 1 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ă. ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref ...: "/app.py": not found Fișierul din COPY nu există în contextul de build, adică în folderul dat lui docker build (de obicei punctul final). Verifică calea relativă la acel folder, nu la Dockerfile, și dacă fișierul nu e exclus în .dockerignore. ERROR: "docker buildx build" requires exactly 1 argument. Lipsește contextul de build, de obicei punctul de la final: scrie docker build -t site:1.0 . (punctul = folderul curent). Același mesaj apare dacă ai pus un argument în plus, de exemplu un tag fără -t. Î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.
