...
Eroare Docker · Dockerfile și docker build

ERROR: "docker buildx build" requires exactly 1 argument.

Pe scurt

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

Greșit
BASH
docker build -t site:1.0
Corect
BASH
docker 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

Greșit
BASH
docker build site:1.0 .
Corect
BASH
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

Greșit
BASH
docker build -t site:1.0 ~/Proiecte noi/site
Corect
BASH
docker build -t site:1.0 "$HOME/Proiecte noi/site"

Spațiul rupe calea în două argumente. Ghilimelele o păstrează întreagă.

Repară tu

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.

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

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