"docker run" requires at least 1 argument.
Comanda docker run nu conține numele imaginii: l-ai uitat, a rămas pe rândul următor după un \ greșit sau o variabilă din script e goală. Pune imaginea după opțiuni: docker run -d --name web -p 8080:80 nginx:1.27-alpine.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Forma lui docker run este docker run [OPȚIUNI] IMAGINE [COMANDĂ] [ARGUMENTE...]. Imaginea e singurul argument obligatoriu. Clientul citește opțiunile (tot ce începe cu -, plus valorile lor) și, dacă după ele nu mai rămâne nimic, afișează mesajul, formatul comenzii și iese cu codul 125.
Pe lângă imaginea uitată, sunt două cauze frecvente în scripturi: o comandă lungă ruptă pe mai multe rânduri cu \, unde după \ a rămas un spațiu (deci rândul următor, cu imaginea, devine o comandă separată), și o variabilă goală (docker run -d $IMAGINE când IMAGINE nu e setată).
Același tip de mesaj îl dau și alte comenzi: "docker exec" requires at least 2 arguments (containerul și comanda), "docker logs" requires exactly 1 argument.
De ce apare: cauzele frecvente
1Imaginea a fost uitată
docker run -d --name web -p 8080:80docker run -d --name web -p 8080:80 nginx:1.27-alpineImaginea vine după opțiuni; fără ea, Docker nu știe ce să pornească.
2Spațiu după \ la continuarea rândului
docker run -d --name web \
nginx:1.27-alpinedocker run -d --name web \
nginx:1.27-alpine\ trebuie să fie ultimul caracter de pe rând; altfel rândul se termină acolo.
3Variabilă goală în script
docker run -d --name api $IMAGINEIMAGINE=${IMAGINE:?lipseste IMAGINE}
docker run -d --name api "$IMAGINE"${VAR:?mesaj} oprește scriptul cu un mesaj clar dacă variabila e goală.
Repară eroarea, direct în pagină
Comanda docker run -d --name web -p 8080:80 dă "docker run" requires at least 1 argument. Completează comanda ca să pornească serverul web din imaginea nginx:1.27-alpine cu numele web și portul 8080, apoi verifică pagina.
Indiciu
Numele imaginii se scrie după toate opțiunile.
Reparația
docker run -d --name web -p 8080:80 nginx:1.27-alpine
curl -s localhost:8080De ce merge
Fără imagine, docker run nu avea ce porni și se oprea înainte să contacteze daemon-ul. Cu nginx:1.27-alpine după opțiuni, Docker creează containerul web din imagine, publică portul 80 pe 8080 și îl pornește în fundal, deci curl localhost:8080 afișează pagina nginx.
Alte forme ale mesajului
"docker run" requires at least 1 argument. See 'docker run --help'. Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]"docker exec" requires at least 2 arguments."docker logs" requires exactly 1 argument.
Cum o eviți pe viitor
Scrie comenzile lungi pe mai multe rânduri, cu \ fără spații după, și imaginea pe ultimul rând, ca să sară în ochi. În scripturi, verifică variabilele obligatorii cu ${VAR:?mesaj}, ca o valoare lipsă să dea un mesaj clar. Și mai simplu, mută configurarea într-un compose.yaml.
Întrebări frecvente
Dar am scris -p 8080:80. Nu e un argument?
E o opțiune cu valoarea ei, nu argumentul cerut. Docker numără ca argumente doar ce rămâne după opțiuni: imaginea, apoi comanda containerului.
Cum văd dacă am un spațiu după \?
cat -A script.sh afișează finalul fiecărui rând cu $. Un rând corect se termină în \$, unul greșit în \ $.
Erori înrudite
unknown shorthand flag: 'f' in -f Opțiunea scurtă nu există pentru această comandă docker (de exemplu docker stop nu are -f). Citește docker <comandă> --help și folosește opțiunea sau comanda potrivită: pentru oprire forțată, docker kill sau docker rm -f. Dacă apare la docker compose up -d, lipsește pluginul Compose. 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. 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 . Î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.
