...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

The Deployment "Web_App" is invalid: metadata.name: Invalid value: "Web_App": a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character

Pe scurt

Numele obiectului nu respectă regulile Kubernetes: doar litere mici, cifre, - și ., începând și terminând cu literă sau cifră. Înlocuiește majusculele și underscore-ul: Web_App devine web-app.

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

Ce înseamnă

Numele majorității obiectelor ajung în DNS (serviciile), în etichete și în căi de fișiere, așa că Kubernetes le validează după standardul RFC 1123: litere mici a-z, cifre, cratimă și punct, maximum 253 de caractere, începând și terminând cu o literă sau o cifră. Mesajul complet include și expresia regulată folosită.

Cele mai dese greșeli: majuscule (Web), underscore (web_app), spații, diacritice sau un nume care se termină în cratimă, de exemplu când e compus dintr-o variabilă goală (api-$VERSIUNE).

Unele tipuri sunt și mai stricte. Serviciile și namespace-urile cer o etichetă DNS (RFC 1123 label): fără punct și maximum 63 de caractere, iar mesajul spune atunci a lowercase RFC 1123 label must consist of....

De ce apare: cauzele frecvente

1Majuscule și underscore

Greșit
YAML
metadata:
  name: Web_App
Corect
YAML
metadata:
  name: web-app

Sunt permise doar litere mici, cifre, - și .

2Nume generat dintr-o variabilă goală

Greșit
YAML
kubectl create deployment api-$VERSIUNE --image=academia/api:1.0
Corect
YAML
VERSIUNE=v1
kubectl create deployment api-$VERSIUNE --image=academia/api:1.0

Cu variabila goală, numele devine api-, care se termină în cratimă.

3Punct într-un nume de Service

Greșit
YAML
kubectl expose deploy web --name=web.v2 --port=80
Corect
YAML
kubectl expose deploy web --name=web-v2 --port=80

Numele serviciilor sunt etichete DNS: fără puncte.

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/web-app.yaml al aplicației unei agenții de turism are numele Web_App peste tot (Deployment, selector, etichete) și kubectl apply dă a lowercase RFC 1123 subdomain. Redenumește aplicația în web-app în tot fișierul și aplică-l.

Indiciu

Un sed -i 's/Web_App/web-app/g' schimbă toate aparițiile.

Alte forme ale mesajului

  • The ConfigMap "a b" is invalid: metadata.name: Invalid value: "a b": a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters, '-' or '.' ...
  • The Service "web.v2" is invalid: metadata.name: Invalid value: "web.v2": a DNS-1035 label must consist of lower case alphanumeric characters or '-', start with an alphabetic character, and end with an alphanumeric character

Cum o eviți pe viitor

  • Adoptă o convenție simplă: litere mici și cratimă (magazin-api, plati-worker).
  • În scripturi, verifică variabilele din care compui nume (set -u).
  • Păstrează numele scurte: serviciile au o limită de 63 de caractere.
  • Validează manifestele cu kubectl apply --dry-run=server -f înainte de livrare.

Întrebări frecvente

De ce nu pot folosi underscore?

Pentru că numele ajung în DNS, iar underscore nu e permis în numele de host. Kubernetes aplică aceeași regulă tuturor obiectelor, ca să nu existe excepții.

Eticheta și numele au aceleași reguli?

Nu chiar. Valorile etichetelor acceptă și majuscule și underscore (maximum 63 de caractere), dar numele obiectelor nu.

Erori înrudite

← Toate erorile Kubernetes

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ță Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.