...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: the Dockerfile cannot be empty

Pe scurt

Fișierul Dockerfile există, dar e gol (0 octeți) sau nu are nicio instrucțiune. De obicei editorul nu l-a salvat ori l-ai creat cu touch. Scrie în el cel puțin un FROM, salvează și rulează din nou docker build.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

docker build a găsit fișierul Dockerfile, deci nu e eroarea no such file or directory, dar conținutul e gol. Fără nicio instrucțiune, BuildKit nu are ce construi și se oprește imediat. Dacă fișierul are doar comentarii sau linii goale, mesajul e file with no instructions.

Situații tipice:

  • ai creat fișierul cu touch Dockerfile sau din explorer și ai uitat să-l salvezi după ce ai scris în el;
  • editorul a salvat textul în alt fișier (Dockerfile.txt, dockerfile în alt folder), iar cel din folderul de build a rămas gol;
  • un script a generat Dockerfile-ul cu o variabilă goală (echo "$CONTINUT" > Dockerfile);
  • -f arată spre alt fișier decât cel editat.

Verifici cu ls -l Dockerfile (dimensiunea 0) și cat Dockerfile.

De ce apare: cauzele frecvente

1Fișier creat, dar nesalvat

Greșit
BASH
touch Dockerfile
docker build -t pagina:1.0 .
Corect
BASH
printf 'FROM nginx:1.27-alpine\nCOPY index.html /usr/share/nginx/html/\n' > Dockerfile
docker build -t pagina:1.0 .

Primul rând al unui Dockerfile trebuie să fie FROM; după ce există instrucțiuni, build-ul are ce construi.

2Textul salvat în alt fișier

Greșit
BASH
ls
# Dockerfile (0 B)  Dockerfile.txt
docker build -t app .
Corect
BASH
mv Dockerfile.txt Dockerfile
docker build -t app .

Docker citește exact Dockerfile din context (sau fișierul dat cu -f).

3-f arată spre fișierul greșit

Greșit
BASH
docker build -f docker/Dockerfile.prod -t app .
# Dockerfile.prod e gol
Corect
BASH
docker build -f docker/Dockerfile -t app .

Cu -f, build-ul citește doar fișierul indicat, oricare ar fi conținutul celorlalte.

Repară tu

Repară eroarea, direct în pagină

În ~/pagina ai index.html, iar docker build -t pagina:1.0 . dă the Dockerfile cannot be empty: fișierul Dockerfile a fost creat, dar a rămas gol. Scrie în el un Dockerfile care servește index.html cu nginx:1.27-alpine, construiește pagina:1.0 și pornește containerul pagina pe portul 8080.

Indiciu

Două linii: FROM nginx:1.27-alpine și COPY index.html /usr/share/nginx/html/.

Alte forme ale mesajului

  • ERROR: failed to solve: file with no instructions
  • failed to solve with frontend dockerfile.v0: failed to create LLB definition: the Dockerfile cannot be empty
  • Error response from daemon: the Dockerfile (Dockerfile) cannot be empty

Cum o eviți pe viitor

După ce editezi Dockerfile-ul, verifică rapid cu cat Dockerfile înainte de build, mai ales când lucrezi în editoare care nu salvează automat. Ține Dockerfile-ul în Git: un git diff gol după editare îți arată că modificarea nu a fost salvată. Dacă folosești -f, scrie calea completă și verific-o cu ls -l.

Întrebări frecvente

Ce diferență e față de „failed to read dockerfile”?

Acolo fișierul nu există deloc (nume sau folder greșit). Aici există, dar e gol.

Un Dockerfile poate avea doar FROM?

Da. FROM nginx:1.27-alpine singur e un Dockerfile valid: imaginea rezultată e o copie a celei de bază, cu alt nume.

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.