...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref ...: "/app.py": not found

Pe scurt

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

Greșit
BASH
# fișierul real: src/app.py
COPY app.py .
Corect
BASH
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

Greșit
BASH
# .dockerignore
config/
# Dockerfile
COPY config/setari.json ./config/
Corect
BASH
# .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

Greșit
BASH
COPY ../shared/utils.py .
Corect
BASH
# 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

Greșit
BASH
docker build -t api -f docker/Dockerfile docker/
Corect
BASH
docker build -t api -f docker/Dockerfile .

Ultimul argument e contextul. Cu docker/, fișierele din rădăcina proiectului nu sunt trimise.

Repară tu

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.

Alte forme ale mesajului

  • COPY failed: file not found in build context or excluded by .dockerignore: stat app.py: file does not exist
  • ERROR: failed to solve: failed to compute cache key: failed to calculate checksum of ref 3f2a...::9b1c...: "/package.json": not found
  • COPY 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 ls din folderul contextului.
  • Recitește .dockerignore câ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

← 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.