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.
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
apiVersion: apps/v1beta1
kind: DeploymentapiVersion: apps/v1
kind: Deploymentapps/v1 e singura versiune actuală pentru Deployment.
2Ingress vechi
apiVersion: extensions/v1beta1
kind: IngressapiVersion: networking.k8s.io/v1
kind: IngressIngress a trecut în networking.k8s.io/v1, cu pathType și service.name/port.
3CronJob vechi
apiVersion: batch/v1beta1
kind: CronJobapiVersion: batch/v1
kind: CronJobbatch/v1beta1 a fost scos în Kubernetes 1.25.
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.
Reparația
Versiunea veche:
kubectl apply -f web.yaml || true
kubectl api-resources | grep deploymentserror: resource mapping not found for name: "web" namespace: "" from "web.yaml": no matches for kind "Deployment" in version "apps/v1beta1"
ensure CRDs are installed first
deployments deploy apps/v1 true DeploymentVersiunea actuală:
sed -i 's#apps/v1beta1#apps/v1#' web.yaml
kubectl apply -f web.yaml
kubectl rollout status deploy/webdeployment.apps/web created
Waiting for deployment "web" rollout to finish: 0 of 2 updated replicas are available...
deployment "web" successfully rolled outDe ce merge
Versiunea apps/v1beta1 a fost scoasă din Kubernetes 1.16, deci clusterul nu mai știe să o interpreteze. apps/v1 e versiunea stabilă a Deploymentului. Manifestul avea deja selectorul explicit, cerut de apps/v1, așa că schimbarea liniei apiVersion ajunge.
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șikubectl 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
The Deployment "web" is invalid: spec.selector: Required value Manifestul Deploymentului nu are spec.selector, care e obligatoriu în apps/v1. Adaugă selector.matchLabels cu aceleași etichete ca în spec.template.metadata.labels (de exemplu app: web). Error from server (BadRequest): error when creating "web.yaml": Deployment in version "v1" cannot be handled as a Deployment: strict decoding error: unknown field "spec.template.spec.containers[0].imagePullPolicyy" Manifestul are un câmp pe care API-ul nu îl cunoaște: o greșeală de tastare (imagePullPolicyy) sau un câmp pus la nivelul greșit de indentare. Corectează numele sau mută câmpul, verificând cu kubectl explain. error: the server doesn't have a resource type "deploymnet" Tipul de obiect scris în comandă nu există în cluster: de obicei e o greșeală de tastare (deploymnet, pod-uri, svcs) sau un tip care vine dintr-un CRD neinstalat. Scrie numele corect (deployment, deploy, pods, svc) și verifică lista completă cu kubectl api-resources. Î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.
