ERROR: failed to solve: base name (${BASE_IMAGE}) should not be blank
FROM folosește o variabilă ARG care, la momentul build-ului, e goală: ARG-ul n-are valoare implicită și n-ai dat --build-arg, sau ARG-ul e declarat după FROM. Pune ARG BASE_IMAGE=node:20-alpine înainte de primul FROM sau rulează docker build --build-arg BASE_IMAGE=node:20-alpine.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
FROM ${BASE_IMAGE} îi permite build-ului să aleagă imaginea de bază dintr-un argument. Când BuildKit înlocuiește variabila și obține un șir gol, nu mai are ce imagine să descarce și se oprește cu base name (${BASE_IMAGE}) should not be blank. Între paranteze vezi chiar textul din Dockerfile, nu valoarea.
Variabila e goală din trei motive: ARG BASE_IMAGE n-are valoare implicită și comanda de build nu dă --build-arg; ARG-ul e declarat după FROM (doar ARG-urile de dinaintea primului FROM pot fi folosite în FROM); numele diferă între ARG și FROM (BASE vs BASE_IMAGE) sau între Dockerfile și --build-arg.
Un alt detaliu: un ARG declarat înainte de FROM nu mai e vizibil după el. Dacă îl folosești și în RUN, repetă ARG BASE_IMAGE (fără valoare) în etapă.
De ce apare: cauzele frecvente
1ARG fără valoare implicită
ARG BASE_IMAGE
FROM ${BASE_IMAGE}ARG BASE_IMAGE=node:20-alpine
FROM ${BASE_IMAGE}Cu valoare implicită, build-ul merge și fără --build-arg, iar valoarea poate fi suprascrisă când vrei.
2ARG declarat după FROM
FROM ${BASE_IMAGE}
ARG BASE_IMAGE=node:20-alpineARG BASE_IMAGE=node:20-alpine
FROM ${BASE_IMAGE}FROM vede doar ARG-urile declarate înaintea lui.
3Nume diferit la --build-arg
docker build --build-arg BASE=node:20-alpine -t api .docker build --build-arg BASE_IMAGE=node:20-alpine -t api .Numele de la --build-arg trebuie să fie exact cel din ARG.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul începe cu ARG BASE_IMAGE și FROM ${BASE_IMAGE}, iar docker build -t api:1.0 . dă base name (${BASE_IMAGE}) should not be blank. Dă argumentului valoarea implicită node:20-alpine, ca build-ul să meargă și fără --build-arg, apoi construiește api:1.0.
Indiciu
ARG BASE_IMAGE=node:20-alpine, înainte de FROM.
Reparația
ARG BASE_IMAGE=node:20-alpine
FROM ${BASE_IMAGE}
WORKDIR /app
COPY server.js .
CMD ["node", "server.js"]docker build -t api:1.0 .
docker run --rm api:1.0API pornitDe ce merge
Fără valoare implicită și fără --build-arg, ${BASE_IMAGE} devenea un șir gol, deci FROM nu avea ce imagine să folosească. Cu ARG BASE_IMAGE=node:20-alpine înainte de FROM, variabila are o valoare la fiecare build, iar cine vrea altă versiune o poate schimba cu --build-arg BASE_IMAGE=node:22-alpine.
Alte forme ale mesajului
ERROR: failed to solve: base name (${NODE_IMAGE}) should not be blankfailed to solve: base name ($BASE) should not be blank
Cum o eviți pe viitor
Dă mereu o valoare implicită ARG-urilor folosite în FROM și pune-le pe primele linii din Dockerfile, ca să fie ușor de găsit. Folosește aceleași nume în Dockerfile, compose.yaml (build.args) și CI. Pentru valori obligatorii, poți scrie FROM ${BASE_IMAGE:?lipseste BASE_IMAGE}, ca build-ul să explice clar ce lipsește în loc de un mesaj general.
Întrebări frecvente
De ce ARG-ul nu se vede în RUN după FROM?
ARG-urile de dinaintea primului FROM aparțin doar liniilor FROM. Ca să folosești valoarea și în etapă, scrie din nou ARG BASE_IMAGE după FROM, fără valoare: preia valoarea de dinainte.
Pot da argumentul din compose.yaml?
Da: build: {context: ., args: {BASE_IMAGE: node:20-alpine}}. Valoarea ajunge la build exact ca un --build-arg.
Erori înrudite
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. Error response from daemon: manifest for nginx:1.99 not found: manifest unknown: manifest unknown Imaginea există pe registry, dar tagul cerut (aici 1.99) nu. Alege un tag care există, de exemplu nginx:1.27 sau nginx:alpine, după lista de taguri de pe pagina imaginii; la imaginile tale, verifică dacă ai urcat chiar tagul pe care îl ceri. WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string. compose.yaml folosește ${DB_PAROLA}, dar variabila nu există nici în shell, nici în fișierul .env de lângă compose.yaml, așa că Compose pune un șir gol. Adaugă DB_PAROLA=valoare în .env (în folderul proiectului) sau exportă variabila înainte de docker compose up. Î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.
