StageNameCasing: Stage name 'Build' should be lowercase (line 1)
Numele etapei dintr-un build multi-stage (FROM ... AS Build) are litere mari. Scrie-l cu litere mici (AS build) și folosește același nume în COPY --from=build și --target build.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-un Dockerfile multi-stage, fiecare FROM ... AS nume dă un nume etapei, ca să o poți folosi în COPY --from=nume, într-un FROM nume ulterior sau în docker build --target nume. BuildKit recomandă ca aceste nume să fie scrise cu litere mici și afișează StageNameCasing când găsește majuscule.
Motivul: numele etapelor se comportă ca referințe de imagini, unde literele mari nu sunt permise, iar amestecul (Build într-un loc, build în altul) duce ușor la erori ca target stage "Build" could not be found sau la un COPY --from care încearcă să descarce o imagine cu acel nume.
Build-ul merge, dar e mai sigur să schimbi numele peste tot în același timp: la AS, la COPY --from și în comenzile sau fișierele care folosesc --target.
De ce apare: cauzele frecvente
1Nume de etapă cu majusculă
FROM node:20-alpine AS Build
...
COPY --from=Build /app/dist /usr/share/nginx/htmlFROM node:20-alpine AS build
...
COPY --from=build /app/dist /usr/share/nginx/htmlNumele e acum cu litere mici, același în ambele locuri.
2Nume în stil CamelCase
FROM python:3.12-slim AS TesteUnitareFROM python:3.12-slim AS teste-unitarePentru nume din mai multe cuvinte, folosește litere mici și cratimă.
3--target cu altă formă
docker build --target Build -t app .docker build --target build -t app .Numele din --target trebuie să fie identic cu cel din AS.
Repară eroarea, direct în pagină
În ~/front, build-ul imaginii front:1 afișează StageNameCasing: Stage name 'Build' should be lowercase (line 1). Redenumește etapa cu litere mici peste tot unde e folosită, reconstruiește front:1 și pornește containerul front pe portul 8080 (pagina trebuie să conțină Magazin).
Indiciu
Schimbă AS Build în AS build și --from=Build în --from=build.
Reparația
FROM node:20-alpine AS build
WORKDIR /app
RUN mkdir dist && echo "<h1>Magazin</h1>" > dist/index.html
FROM nginx:1.27-alpine
COPY --from=build /app/dist /usr/share/nginx/htmldocker build -t front:1 .
docker run -d --name front -p 8080:80 front:1De ce merge
Numele etapei apărea de două ori: la AS și la COPY --from. Scris cu litere mici în ambele locuri, BuildKit găsește etapa, nu mai afișează avertismentul, iar nginx primește fișierele generate în prima etapă. Imaginea finală e aceeași ca înainte, doar Dockerfile-ul e curat.
Alte forme ale mesajului
StageNameCasing: Stage name 'Productie' should be lowercase (line 6)- StageNameCasing: Stage name 'Builder' should be lowercase (line 1)
Cum o eviți pe viitor
Alege nume scurte, cu litere mici, pentru etape: build, test, productie, deps. Copiază numele exact când scrii COPY --from și --target. Rulează docker build --check . (sau hadolint în editor) ca să prinzi avertismentele de stil înainte de commit. Dacă redenumești o etapă, caută numele vechi în tot proiectul (Dockerfile, scripturi, CI), ca să nu rămână referințe la el.
Întrebări frecvente
Dacă schimb doar AS, nu și COPY --from, ce se întâmplă?
COPY --from=Build nu mai găsește etapa și BuildKit încearcă să folosească o imagine numită Build, ceea ce eșuează. De aceea schimbi numele peste tot deodată.
Avertismentul schimbă imaginea finală?
Nu. Etapele intermediare nu ajung în imaginea finală, iar numele lor nu apare în ea.
Erori înrudite
FromAsCasing: 'as' and 'FROM' keywords' casing do not match (line 1) Avertisment de stil: ai scris FROM cu litere mari și as cu litere mici (FROM node:20-alpine as build). Scrie-le la fel, de obicei amândouă cu majuscule: FROM node:20-alpine AS build. Build-ul merge oricum. ERROR: failed to solve: target stage "productie" could not be found 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. invalid reference format: repository name (MagazinWeb) must be lowercase Numele imaginilor Docker pot conține doar litere mici, cifre și separatorii . _ - /, deci MagazinWeb e refuzat. Scrie numele cu litere mici, de exemplu docker build -t magazin-web:1.0 . Î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.
