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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
docker build are nevoie de un singur argument fără opțiune: contextul de build, adică folderul (sau URL-ul) cu fișierele trimise daemon-ului. Aproape mereu acesta e ., folderul curent. În Docker 23+, docker build e un alias pentru docker buildx build, de aceea mesajul pomenește buildx.
requires exactly 1 argument înseamnă că numărul de argumente libere nu e 1: fie zero (ai uitat punctul, cea mai frecventă greșeală, mai ales când copiezi comanda dintr-un text unde punctul s-a pierdut la final de propoziție), fie două sau mai multe (de exemplu docker build site:1.0 ., unde lipsește -t, sau o cale cu spații fără ghilimele).
Builder-ul vechi avea varianta "docker build" requires exactly 1 argument., cu același sens.
De ce apare: cauzele frecvente
1Lipsește punctul de la final
docker build -t site:1.0docker build -t site:1.0 .Punctul e contextul de build. Fără el, Docker nu știe ce fișiere să folosească.
2Tag dat fără -t
docker build site:1.0 .docker build -t site:1.0 .Fără -t, site:1.0 e luat drept al doilea context, deci sunt două argumente.
3Cale cu spații fără ghilimele
docker build -t site:1.0 ~/Proiecte noi/sitedocker build -t site:1.0 "$HOME/Proiecte noi/site"Spațiul rupe calea în două argumente. Ghilimelele o păstrează întreagă.
Repară eroarea, direct în pagină
În ~/site ai index.html și un Dockerfile gata scris, dar docker build -t site:1.0 dă "docker buildx build" requires exactly 1 argument. Construiește imaginea site:1.0 din folderul curent, apoi pornește containerul site din ea, pe portul 8080.
Indiciu
Contextul de build e folderul curent, scris ca un punct la finalul comenzii.
Reparația
Adaugă contextul, punctul de la final:
docker build -t site:1.0 .
docker run -d --name site -p 8080:80 site:1.0
curl -s localhost:8080<h1>Florăria Lalea</h1>De ce merge
docker build primește opțiuni (-t site:1.0) și exact un argument liber: contextul. Fără punct, numărul de argumente e zero și comanda se oprește înainte să citească Dockerfile-ul. Cu . la final, folderul ~/site e trimis ca context, Dockerfile-ul e găsit acolo, iar COPY index.html are de unde lua fișierul.
Alte forme ale mesajului
"docker build" requires exactly 1 argument. See 'docker build --help'.ERROR: "docker buildx build" requires exactly 1 argument. See 'docker buildx build --help'.
Cum o eviți pe viitor
Memorează forma completă: docker build -t nume:tag ., cu punctul ca ultim caracter. Pune comanda într-un script sau într-un Makefile al proiectului ca să n-o mai tastezi. Folosește ghilimele în jurul căilor, iar pentru proiecte cu mai multe servicii lasă Docker Compose să facă build-ul (build: . în compose.yaml, apoi docker compose build).
Întrebări frecvente
Ce înseamnă de fapt punctul?
Folderul curent, trimis ca context de build. Poți da orice alt folder (docker build -t api ./api) sau un URL Git. Dockerfile-ul e căutat implicit în acel folder.
De ce apare buildx dacă eu am scris docker build?
Din Docker 23, docker build folosește BuildKit prin pluginul buildx, deci comanda e redirecționată la docker buildx build, iar mesajele de eroare îl pomenesc.
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. invalid reference format: repository name (MagazinWeb) must be lowercase Numele imaginilor Docker pot conține doar litere mici, cifre și separatorii . _ - /, deci MagazinWeb e refuzat. Scrie numele cu litere mici, de exemplu docker build -t magazin-web:1.0 . 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. Î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.
