...
Eroare Docker · Comenzi și opțiuni docker scrise greșit

"docker run" requires at least 1 argument.

Pe scurt

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ă

Greșit
BASH
docker run -d --name web -p 8080:80
Corect
BASH
docker run -d --name web -p 8080:80 nginx:1.27-alpine

Imaginea vine după opțiuni; fără ea, Docker nu știe ce să pornească.

2Spațiu după \ la continuarea rândului

Greșit
BASH
docker run -d --name web \ 
  nginx:1.27-alpine
Corect
BASH
docker 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

Greșit
BASH
docker run -d --name api $IMAGINE
Corect
BASH
IMAGINE=${IMAGINE:?lipseste IMAGINE}
docker run -d --name api "$IMAGINE"

${VAR:?mesaj} oprește scriptul cu un mesaj clar dacă variabila e goală.

Repară tu

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.

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

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