...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: target stage "productie" could not be found

Pe scurt

Numele dat la --target nu e numele niciunei etape din Dockerfile (cel scris după AS în FROM ... AS nume). Uită-te la liniile FROM, folosește exact numele etapei (de exemplu --target prod) sau redenumește etapa.

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

Ce înseamnă

Într-un Dockerfile multi-stage, fiecare FROM imagine AS nume începe o etapă cu un nume. docker build --target nume construiește doar până la acea etapă (inclusiv), util pentru o imagine de teste sau de dezvoltare.

Mesajul apare înainte de orice pas: Docker a citit Dockerfile-ul și n-a găsit nicio etapă cu numele cerut. Cauzele sunt banale, dar frecvente: numele din comandă diferă de cel din Dockerfile (productie vs prod), etapa n-are deloc AS nume (etapele fără nume au doar un număr, 0, 1, 2...), ai folosit alt Dockerfile decât crezi (lipsește -f), sau pipeline-ul CI folosește un nume vechi, după ce cineva a redenumit etapa.

Numele etapelor nu țin cont de litere mari și mici, dar trebuie să fie exacte în rest.

De ce apare: cauzele frecvente

1Nume diferit de cel din AS

Greșit
BASH
# Dockerfile: FROM node:20-alpine AS prod
docker build --target productie -t api:prod .
Corect
BASH
docker build --target prod -t api:prod .

--target primește exact numele scris după AS.

2Etapa n-are nume

Greșit
BASH
FROM node:20-alpine
RUN npm test
Corect
BASH
FROM node:20-alpine AS teste
RUN npm test

Fără AS, etapa nu poate fi aleasă după nume la --target.

3Alt Dockerfile decât cel cu etapa

Greșit
BASH
docker build --target dev -t api:dev .
Corect
BASH
docker build -f Dockerfile.dev --target dev -t api:dev .

Etapa dev există doar în Dockerfile.dev. Fără -f, Docker citește Dockerfile.

Repară tu

Repară eroarea, direct în pagină

În ~/site, Dockerfile-ul are două etape: build și prod. Comanda din documentația proiectului, docker build --target productie -t site:prod ., dă target stage "productie" could not be found. Construiește imaginea site:prod din etapa corectă.

Indiciu

Numele etapelor sunt cele de după AS în liniile FROM.

Alte forme ale mesajului

  • failed to solve: target stage "test" could not be found
  • ERROR: failed to solve: target stage "build" could not be found

Cum o eviți pe viitor

Dă nume scurte și stabile etapelor (build, teste, prod) și scrie-le cu aceeași formă peste tot. Înainte de --target, listează-le cu grep -n '^FROM' Dockerfile. Când redenumești o etapă, caută numele vechi în compose.yaml (build.target), în scripturile CI și în documentația proiectului, ca să nu rămână comenzi care cer o etapă inexistentă.

Întrebări frecvente

Pot folosi numărul etapei la --target?

Nu, --target acceptă doar nume. Numerele (0, 1, ...) pot fi folosite la COPY --from=0, dar e mai clar să dai nume etapelor.

Fără --target ce etapă se construiește?

Ultima etapă din fișier, plus toate etapele de care depinde prin COPY --from. Etapele de care nu depinde nimic sunt sărite de BuildKit.

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.