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

error: error validating "job.yaml": error validating data: apiVersion not set; if you choose to ignore these errors, turn validation off with --validate=false

Pe scurt

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

Greșit
YAML
kind: Job
metadata:
  name: raport
Corect
YAML
apiVersion: batch/v1
kind: Job
metadata:
  name: raport

Job face parte din grupul batch, versiunea v1.

2Cheie scrisă greșit

Greșit
YAML
apiversion: v1
kind: Pod
Corect
YAML
apiVersion: v1
kind: Pod

Cheile sunt camelCase; apiversion e alt câmp.

3Separator --- în mijlocul obiectului

Greșit
YAML
apiVersion: v1
---
kind: ConfigMap
Corect
YAML
---
apiVersion: v1
kind: ConfigMap

--- împarte fișierul în documente; aici apiVersion a rămas în documentul anterior.

Repară tu

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.

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 și kind, înainte de orice altceva.
  • Află versiunea unui tip cu kubectl explain job | head -3 sau kubectl api-resources.
  • Nu folosi --validate=false ca 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

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