unable to prepare context: path "/home/ana/magazin/api" not found
Folderul dat la build: în compose.yaml (sau ca context la docker build) nu există la acea cale. Căile sunt relative la folderul compose.yaml: verifică numele real cu ls (backend, nu api; litere mari) și corectează build: ./backend.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
build: ./api îi spune lui Compose să construiască imaginea serviciului din folderul api, aflat lângă compose.yaml. Înainte de build, clientul pregătește contextul, adică arhivează folderul pentru BuildKit. Dacă folderul nu există, se oprește aici, cu calea absolută în mesaj.
Motivele obișnuite: folderul are alt nume (backend, API, pe Linux literele mari contează); ai mutat compose.yaml într-un subfolder, iar căile relative acum pornesc din alt loc; folderul e un submodul Git care n-a fost descărcat (git submodule update --init); scrii o cale absolută de pe calculatorul unui coleg.
Același mesaj îl dă docker build cale când calea nu există. Compară calea din mesaj cu ls din folderul proiectului.
De ce apare: cauzele frecvente
1Folderul are alt nume
services:
api:
build: ./api
# în proiect: backend/services:
api:
build: ./backendCalea trebuie să fie folderul real cu Dockerfile-ul.
2compose.yaml mutat în subfolder
# deploy/compose.yaml
services:
api:
build: ./backend# deploy/compose.yaml
services:
api:
build: ../backendCăile din compose.yaml sunt relative la folderul fișierului.
3Submodul Git nedescărcat
git clone https://git.firma.ro/magazin.git
docker compose buildgit submodule update --init
docker compose buildFolderul submodulului e gol sau lipsește până îl descarci.
Repară eroarea, direct în pagină
În ~/magazin, compose.yaml construiește serviciul api cu build: ./api, dar codul și Dockerfile-ul sunt în folderul backend, iar docker compose up -d dă unable to prepare context: path "/home/elev/magazin/api" not found. Repară calea și pornește proiectul (imaginea se construiește din backend).
Indiciu
ls în folderul proiectului; apoi build: ./backend.
Reparația
services:
api:
build: ./backend
ports:
- "8080:80"docker compose up -d
curl -s localhost:8080<h1>API magazin</h1>De ce merge
Compose rezolvă ./api față de folderul lui compose.yaml, adică /home/elev/magazin/api, care nu exista. Cu build: ./backend, contextul e folderul real cu Dockerfile-ul și cu index.html, deci imaginea se construiește, iar serviciul api pornește din ea și răspunde pe portul 8080.
Alte forme ale mesajului
ERROR: unable to prepare context: path "/home/ana/magazin/api" not foundunable to prepare context: path "./api" not foundfailed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
Cum o eviți pe viitor
Ține compose.yaml în rădăcina proiectului, cu căi relative scurte (./backend). Verifică cu docker compose config, care afișează căile absolute rezolvate pentru fiecare build.context, deci vezi imediat un folder greșit. După clonare, rulează git submodule update --init dacă proiectul are submodule.
Întrebări frecvente
Pot da și un alt Dockerfile la build?
Da, cu forma lungă: build: {context: ./backend, dockerfile: docker/Dockerfile.prod}. Calea dockerfile e relativă la context.
Pot construi direct dintr-un repository Git?
Da, build: https://github.com/firma/api.git#main folosește repository-ul ca context. E util pentru unelte, dar pentru codul tău e mai clar un folder local.
Erori înrudite
ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory docker build caută fișierul numit exact Dockerfile în folderul de context (punctul de la final), iar acolo nu există: ești în alt folder, fișierul are alt nume (dockerfile.txt, Dockerfile.dev) sau e într-un subfolder. Intră în folderul corect sau arată-i fișierul cu -f: docker build -f docker/Dockerfile -t api:1.0 . 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. service "web" has neither an image nor a build context specified: invalid compose project Serviciul din compose.yaml nu spune de unde vine containerul: n-are nici image:, nici build:. Adaugă image: nginx:1.27-alpine (o imagine existentă) sau build: . (construiește din Dockerfile-ul proiectului); verifică și indentarea, poate image e sub alt serviciu. Î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.
