...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: base name (${BASE_IMAGE}) should not be blank

Pe scurt

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ă

Greșit
BASH
ARG BASE_IMAGE
FROM ${BASE_IMAGE}
Corect
BASH
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

Greșit
BASH
FROM ${BASE_IMAGE}
ARG BASE_IMAGE=node:20-alpine
Corect
BASH
ARG BASE_IMAGE=node:20-alpine
FROM ${BASE_IMAGE}

FROM vede doar ARG-urile declarate înaintea lui.

3Nume diferit la --build-arg

Greșit
BASH
docker build --build-arg BASE=node:20-alpine -t api .
Corect
BASH
docker build --build-arg BASE_IMAGE=node:20-alpine -t api .

Numele de la --build-arg trebuie să fie exact cel din ARG.

Repară tu

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.

Alte forme ale mesajului

  • ERROR: failed to solve: base name (${NODE_IMAGE}) should not be blank
  • failed 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

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