error: error validating "job.yaml": error validating data: apiVersion not set; if you choose to ignore these errors, turn validation off with --validate=false
Manifestul nu are câmpul apiVersion (sau e indentat greșit), deci kubectl nu știe în ce grup al API-ului e obiectul. Adaugă pe prima linie versiunea corectă: v1 pentru Pod/Service/ConfigMap, apps/v1 pentru Deployment, batch/v1 pentru Job și CronJob.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
kubectl identifică tipul obiectului din perechea apiVersion + kind. Fără apiVersion, nu poate valida manifestul și nici nu știe la ce adresă a API-ului să-l trimită. Sugestia cu --validate=false nu ajută: fără versiune, serverul tot nu poate crea obiectul.
Cauze: linia lipsește (copiată doar parțial), are o greșeală de tastare în cheie (apiversion, api-version), e indentată cu spații în față (devine parte din alt obiect) sau separatorul --- dintre documente a ajuns în mijlocul unui obiect.
Versiunile uzuale: v1 (Pod, Service, ConfigMap, Secret, Namespace, PVC), apps/v1 (Deployment, StatefulSet, DaemonSet), batch/v1 (Job, CronJob), networking.k8s.io/v1 (Ingress, NetworkPolicy), rbac.authorization.k8s.io/v1 (Role, RoleBinding).
De ce apare: cauzele frecvente
1Linia lipsește
kind: Job
metadata:
name: raportapiVersion: batch/v1
kind: Job
metadata:
name: raportJob face parte din grupul batch, versiunea v1.
2Cheie scrisă greșit
apiversion: v1
kind: PodapiVersion: v1
kind: PodCheile sunt camelCase; apiversion e alt câmp.
3Separator --- în mijlocul obiectului
apiVersion: v1
---
kind: ConfigMap---
apiVersion: v1
kind: ConfigMap--- împarte fișierul în documente; aici apiVersion a rămas în documentul anterior.
Repară eroarea, direct în pagină
Job-ul raport (un raport zilnic de vânzări, imaginea academia/raport:1.0) din ~/k8s/job.yaml nu are apiVersion, iar kubectl apply dă apiVersion not set. Adaugă versiunea corectă pentru un Job, aplică fișierul și verifică faptul că jobul se termină cu succes.
Indiciu
Job face parte din grupul batch, versiunea v1.
Reparația
Validarea eșuează:
kubectl apply -f job.yaml || trueerror: error validating "job.yaml": error validating data: apiVersion not set; if you choose to ignore these errors, turn validation off with --validate=falseAdaugă apiVersion și aplică:
sed -i '1i apiVersion: batch/v1' job.yaml
head -3 job.yaml
kubectl apply -f job.yaml
kubectl wait --for=condition=complete job/raport --timeout=60sapiVersion: batch/v1
kind: Job
metadata:
job.batch/raport created
job.batch/raport condition metDe ce merge
kubectl folosește apiVersion și kind ca să știe ce obiect validează și unde îl trimite. Pentru un Job, perechea este batch/v1 + Job. După ce adaugi linia, manifestul e complet, Job-ul pornește un pod, iar raportul se termină cu codul 0.
Alte forme ale mesajului
error: error validating "b.yaml": error validating data: kind not set; if you choose to ignore these errors, turn validation off with --validate=false
Cum o eviți pe viitor
- Începe fiecare manifest cu
apiVersionșikind, înainte de orice altceva. - Află versiunea unui tip cu
kubectl explain job | head -3saukubectl api-resources. - Nu folosi
--validate=falseca să treci peste erori: ascunde problema, nu o rezolvă. - Păstrează manifestele în git și verifică-le automat în pipeline cu
kubectl apply --dry-run=server.
Întrebări frecvente
Cum aflu apiVersion pentru un tip?
kubectl api-resources are coloana APIVERSION, iar kubectl explain TIP afișează GROUP și VERSION în primele rânduri.
Ce face --validate=false?
Oprește validarea din kubectl, iar serverul face oricum propriile verificări. La lipsa lui apiVersion, cererea eșuează în continuare.
Erori înrudite
error: error validating "cm.yaml": error validating data: kind not set; if you choose to ignore these errors, turn validation off with --validate=false Manifestul nu spune ce fel de obiect este: lipsește câmpul kind sau e scris greșit. Adaugă kind: ConfigMap (Pod, Deployment, Service etc.), cu majuscula exactă, sub apiVersion. error: resource mapping not found for name: "web" namespace: "" from "web.yaml": no matches for kind "Deployment" in version "apps/v1beta1" apiVersion din manifest nu mai există în clusterul tău: apps/v1beta1, extensions/v1beta1 și altele au fost scoase. Schimbă-l în versiunea actuală (apps/v1 pentru Deployment, networking.k8s.io/v1 pentru Ingress) și verifică lista cu kubectl api-versions. error: no objects passed to apply Fișierul dat la kubectl apply -f nu conține niciun obiect: e gol, are doar comentarii sau separatoare ---, ori folderul nu are fișiere .yaml. Verifică conținutul cu cat și scrie manifestul (apiVersion, kind, metadata, spec). Î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.
