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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La docker build -t app ., punctul de la final e contextul de build: folderul trimis daemon-ului. Instrucțiunile COPY și ADD pot lua fișiere doar din el, iar căile se citesc relativ la el. BuildKit calculează o sumă de control pentru fiecare sursă din COPY; când sursa lipsește, primești failed to calculate checksum of ref …: "/app.py": not found, iar deasupra, blocul cu >>> îți arată linia exactă din Dockerfile.
Cauze frecvente: fișierul e într-un subfolder (src/app.py), numele diferă (majuscule, extensie), ai rulat build-ul din alt folder, ai dat ca context un subfolder (docker build -f docker/Dockerfile docker/), încerci să copiezi ceva din afara contextului (COPY ../config.json .) sau fișierul e exclus în .dockerignore.
Builder-ul vechi (fără BuildKit) spunea același lucru mai direct: COPY failed: file not found in build context or excluded by .dockerignore.
De ce apare: cauzele frecvente
1Fișierul e într-un subfolder
# fișierul real: src/app.py
COPY app.py .COPY src/app.py .Căile din COPY pornesc din rădăcina contextului. app.py nu există acolo, src/app.py da.
2Fișierul e exclus în .dockerignore
# .dockerignore
config/
# Dockerfile
COPY config/setari.json ./config/# .dockerignore
node_modules
# Dockerfile
COPY config/setari.json ./config/Ce e exclus în .dockerignore nu ajunge în context, deci COPY nu-l găsește, chiar dacă fișierul există pe disc.
3Cale din afara contextului
COPY ../shared/utils.py .# rulează build-ul din folderul părinte:
docker build -f api/Dockerfile -t api .
# și în Dockerfile:
COPY shared/utils.py .Docker nu poate ieși din context cu ../. Mărește contextul (folderul părinte) și dă Dockerfile-ul cu -f.
4Contextul dat e alt folder
docker build -t api -f docker/Dockerfile docker/docker build -t api -f docker/Dockerfile .Ultimul argument e contextul. Cu docker/, fișierele din rădăcina proiectului nu sunt trimise.
Repară eroarea, direct în pagină
În ~/comenzi, scriptul Python e în src/app.py, dar docker build -t comenzi:1.0 . se oprește la COPY app.py . cu "/app.py": not found. Repară instrucțiunea COPY din Dockerfile, construiește imaginea comenzi:1.0 și rulează-o cu docker run --rm comenzi:1.0.
Indiciu
Calea din COPY se citește din folderul ~/comenzi (contextul), deci trebuie să includă subfolderul.
Reparația
Calea corectă, relativă la context:
sed -i 's|^COPY app.py .|COPY src/app.py .|' Dockerfile
docker build -t comenzi:1.0 .
docker run --rm comenzi:1.0Comenzi procesate: 27Dockerfile-ul final:
FROM python:3.12-slim
WORKDIR /app
COPY src/app.py .
CMD ["python", "app.py"]De ce merge
Contextul de build este ~/comenzi, iar acolo scriptul se află la src/app.py, nu la app.py. Cu COPY src/app.py ., BuildKit găsește fișierul, îl copiază în /app/app.py (folderul din WORKDIR), iar CMD ["python", "app.py"] îl rulează. Restul Dockerfile-ului rămâne neschimbat, iar build-ul trece de pasul COPY.
Alte forme ale mesajului
COPY failed: file not found in build context or excluded by .dockerignore: stat app.py: file does not existERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref 3f2a...::9b1c...: "/package.json": not foundCOPY failed: forbidden path outside the build context: ../shared/utils.py ()
Cum o eviți pe viitor
- Ține Dockerfile-ul în rădăcina proiectului și rulează build-ul de acolo, cu
.ca context. - Scrie căile din COPY exact cum le vezi cu
lsdin folderul contextului. - Recitește
.dockerignorecând un COPY eșuează: excluderile largi (*,config/) ascund fișiere necesare; poți readăuga cu!config/setari.json. - Pentru monorepo, folosește ca context folderul comun și
-f cale/Dockerfile.
Întrebări frecvente
Fișierul există, îl văd cu ls. De ce nu-l găsește?
Verifică trei lucruri: că ls îl arată din folderul pe care l-ai dat ca context (ultimul argument al lui docker build), că numele e identic (inclusiv majuscule) și că nu e exclus în .dockerignore.
Calea din COPY e relativă la Dockerfile?
Nu, la contextul de build. Dockerfile-ul poate sta oriunde (-f); sursele din COPY se caută mereu în context.
Erori înrudite
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. 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.
