...
Eroare Docker · Dockerfile și docker build

StageNameCasing: Stage name 'Build' should be lowercase (line 1)

Pe scurt

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ă

Greșit
BASH
FROM node:20-alpine AS Build
...
COPY --from=Build /app/dist /usr/share/nginx/html
Corect
BASH
FROM node:20-alpine AS build
...
COPY --from=build /app/dist /usr/share/nginx/html

Numele e acum cu litere mici, același în ambele locuri.

2Nume în stil CamelCase

Greșit
BASH
FROM python:3.12-slim AS TesteUnitare
Corect
BASH
FROM python:3.12-slim AS teste-unitare

Pentru nume din mai multe cuvinte, folosește litere mici și cratimă.

3--target cu altă formă

Greșit
BASH
docker build --target Build -t app .
Corect
BASH
docker build --target build -t app .

Numele din --target trebuie să fie identic cu cel din AS.

Repară tu

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.

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

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