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
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
metadata:
name: Web_Appmetadata:
name: web-appSunt permise doar litere mici, cifre, - și .
2Nume generat dintr-o variabilă goală
kubectl create deployment api-$VERSIUNE --image=academia/api:1.0VERSIUNE=v1
kubectl create deployment api-$VERSIUNE --image=academia/api:1.0Cu variabila goală, numele devine api-, care se termină în cratimă.
3Punct într-un nume de Service
kubectl expose deploy web --name=web.v2 --port=80kubectl expose deploy web --name=web-v2 --port=80Numele serviciilor sunt etichete DNS: fără puncte.
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.
Reparația
Validarea eșuează:
kubectl apply -f web-app.yaml || trueError from server (Invalid): error when creating "web-app.yaml": 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 (e.g. 'example.com', regex used for validation is '[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*')
* spec.template.spec.containers[0].name: Invalid value: "Web_App": a lowercase RFC 1123 label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character (e.g. 'my-name', or '123-abc', regex used for validation is '[a-z0-9]([-a-z0-9]*[a-z0-9])?')Redenumește și aplică:
sed -i 's/Web_App/web-app/g' web-app.yaml
kubectl apply -f web-app.yaml
kubectl get deploy web-appdeployment.apps/web-app created
NAME READY UP-TO-DATE AVAILABLE AGE
web-app 0/1 1 0 2sDe ce merge
Numele obiectelor trebuie să fie nume DNS valide: litere mici, cifre și cratimă. Web_App are majuscule și underscore, deci API server-ul respinge Deploymentul. Etichetele ar accepta valoarea, dar e mai curat ca numele, selectorul și etichetele să fie identice, de aceea le schimbi pe toate.
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
Error from server (AlreadyExists): error when creating "web.yaml": deployments.apps "web" already exists Încerci să creezi un obiect care există deja cu același nume în namespace. kubectl create (sau create -f) doar creează; ca să actualizezi obiectul din fișier, folosește kubectl apply -f, care creează sau modifică după caz. The ConfigMap "setari" is invalid: data[ora deschidere]: Invalid value: "ora deschidere": a valid config key must consist of alphanumeric characters, '-', '_' or '.' (e.g. 'key.name', or 'KEY_NAME', or 'key-name', regex used for validation is '[-._a-zA-Z0-9]+') Numele unei chei din ConfigMap sau Secret conține caractere nepermise (spațiu, diacritice, /). Folosește doar litere, cifre, -, _ și ., de exemplu ORA_DESCHIDERE. The Pod "" is invalid: metadata.name: Required value: name or generateName is required Manifestul nu are metadata.name, deci obiectul nu are nume. Adaugă metadata: name: web (sau metadata.generateName pentru nume generate la kubectl create). Verifică și indentarea: name trebuie să fie sub metadata. Î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.
