ERROR: failed to solve: When using COPY with more than one source file, the destination must be a directory and end with a /
Copiezi mai multe fișiere (sau un model ca *.json) într-o destinație fără / la final, iar Docker nu știe dacă e un fișier sau un folder. Pune / la capătul destinației: COPY package.json package-lock.json ./ sau COPY a.txt b.txt /app/.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La COPY sursa destinatie, destinația fără / la final poate fi un fișier: COPY config.json /app/setari.json copiază și redenumește. Cu mai multe surse, redenumirea nu are sens, deci Docker cere explicit un folder, marcat prin / la final.
Regula se aplică și când ai o singură sursă scrisă cu wildcard care se potrivește cu mai multe fișiere (COPY *.json /app): dacă modelul prinde două fișiere, apare eroarea; dacă prinde unul, merge. De aceea build-ul poate funcționa la tine și să cadă la un coleg care are un fișier în plus.
Reparația e mereu aceeași: / la finalul destinației. Folderul e creat automat dacă nu există. Același mesaj îl dă și ADD.
De ce apare: cauzele frecvente
1Două fișiere, destinație fără /
COPY package.json package-lock.json /appCOPY package.json package-lock.json /app/Cu / la final, /app e tratat ca folder și primește ambele fișiere.
2Wildcard care prinde mai multe fișiere
COPY *.json .
# merge
COPY *.json /app
# eroare cu 2+ fișiereCOPY *.json /app/Modelul poate prinde mai multe fișiere; destinația trebuie să fie folder.
3WORKDIR folosit fără ./
WORKDIR /app
COPY requirements.txt setup.py .WORKDIR /app
COPY requirements.txt setup.py ././ este folderul curent (WORKDIR), marcat explicit ca folder.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul copiază package.json și server.js cu COPY package.json server.js /app, iar build-ul dă When using COPY with more than one source file, the destination must be a directory. Repară linia, construiește api:1.0 și verifică că ambele fișiere ajung în /app.
Indiciu
Destinația trebuie să se termine cu /.
Reparația
FROM node:20-alpine
WORKDIR /app
COPY package.json server.js /app/
CMD ["node", "server.js"]docker build -t api:1.0 .
docker run --rm api:1.0 ls /apppackage.json
server.jsDe ce merge
Cu două surse, Docker nu poate copia ambele fișiere într-un singur fișier /app, de aceea cere un folder. /app/, cu / la final, e tratat explicit ca folder, deci package.json și server.js ajung amândouă în el, iar build-ul continuă. Folderul ar fi fost creat automat chiar dacă nu exista încă în imagine.
Alte forme ale mesajului
When using COPY with more than one source file, the destination must be a directory and end with a /ERROR: failed to solve: When using ADD with more than one source file, the destination must be a directory and end with a /
Cum o eviți pe viitor
Pune din obișnuință / la finalul oricărei destinații care e folder: COPY . /app/, COPY *.json ./, COPY src/ /app/src/. Lasă destinația fără / doar când chiar vrei să copiezi un singur fișier sub alt nume. Când folosești wildcard-uri, gândește-te că mâine modelul poate prinde mai multe fișiere decât azi.
Întrebări frecvente
De ce COPY . . merge fără /?
Pentru că sursa e un singur folder (contextul), iar Docker îi copiază conținutul în destinație. Regula cu / se aplică doar când sunt mai multe surse.
Trebuie să creez folderul înainte cu RUN mkdir?
Nu. COPY creează automat folderul destinație (și părinții lui) dacă nu există.
Erori înrudite
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: 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. 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ă. Î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.
