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

error: resource mapping not found for name: "web" namespace: "" from "web.yaml": no matches for kind "Deployment" in version "apps/v1beta1"

Pe scurt

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.

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

Ce înseamnă

Fiecare tip de obiect există în anumite grupuri și versiuni ale API-ului. Kubernetes scoate periodic versiunile beta: extensions/v1beta1 și apps/v1beta1/v1beta2 pentru Deployment au dispărut în 1.16, Ingress networking.k8s.io/v1beta1 în 1.22, CronJob batch/v1beta1 în 1.25. Un manifest vechi aplicat pe un cluster nou dă acest mesaj: kubectl nu găsește combinația kind + apiVersion.

Mesajul se termină cu ensure CRDs are installed first, pentru că aceeași eroare apare și la tipurile personalizate al căror CRD nu e instalat.

Schimbarea versiunii poate cere și alte modificări: apps/v1 cere selectorul explicit, iar Ingress v1 are altă structură pentru backend.

De ce apare: cauzele frecvente

1Deployment vechi

Greșit
YAML
apiVersion: apps/v1beta1
kind: Deployment
Corect
YAML
apiVersion: apps/v1
kind: Deployment

apps/v1 e singura versiune actuală pentru Deployment.

2Ingress vechi

Greșit
YAML
apiVersion: extensions/v1beta1
kind: Ingress
Corect
YAML
apiVersion: networking.k8s.io/v1
kind: Ingress

Ingress a trecut în networking.k8s.io/v1, cu pathType și service.name/port.

3CronJob vechi

Greșit
YAML
apiVersion: batch/v1beta1
kind: CronJob
Corect
YAML
apiVersion: batch/v1
kind: CronJob

batch/v1beta1 a fost scos în Kubernetes 1.25.

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/web.yaml al unei biblioteci online folosește apiVersion: apps/v1beta1, iar kubectl apply dă no matches for kind "Deployment" in version "apps/v1beta1". Treci manifestul pe versiunea actuală a API-ului și aplică-l.

Indiciu

kubectl api-resources | grep deployments arată grupul și versiunea actuale.

Alte forme ale mesajului

  • error: unable to recognize "web.yaml": no matches for kind "Deployment" in version "extensions/v1beta1"
  • error: resource mapping not found for name: "web" namespace: "" from "ing.yaml": no matches for kind "Ingress" in version "networking.k8s.io/v1beta1" ensure CRDs are installed first

Cum o eviți pe viitor

  • Verifică versiunile disponibile: kubectl api-versions și kubectl api-resources.
  • Înainte de upgrade-ul clusterului, caută în manifeste și charturi API-urile depreciate (unelte ca pluto sau kubent).
  • Generează scheletele cu kubectl din versiunea clusterului, nu le copia din articole vechi.
  • Citește notele de versiune la fiecare upgrade de Kubernetes.

Întrebări frecvente

De ce ensure CRDs are installed first?

Pentru că kubectl nu poate deosebi un tip scos din API de un tip personalizat neinstalat: în ambele cazuri combinația nu există. Pentru Deployment, problema e versiunea.

Trebuie să schimb ceva în obiectele deja existente în cluster?

Nu. Serverul le-a convertit automat la versiunea nouă. Doar fișierele vechi din git și charturi trebuie actualizate.

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.