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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
kubectl întreabă API server-ul ce tipuri de obiecte cunoaște și caută cuvântul pe care l-ai scris printre numele lor: forma la plural (deployments), la singular (deployment) și scurtă (deploy). Dacă nu găsește nimic, afișează mesajul acesta, cu textul exact între ghilimele.
Cel mai des e o literă inversată sau un nume tradus (kubectl get poduri). Mai rar, tipul chiar nu există în clusterul acesta: resurse personalizate (CRD-uri) ale unui operator neinstalat, de exemplu certificates de la cert-manager, sau un tip disponibil în altă versiune de Kubernetes.
Ca să vezi numele acceptate, rulează kubectl api-resources: coloana NAME are pluralul, iar SHORTNAMES formele scurte (po, deploy, svc, cm, ns, pvc).
De ce apare: cauzele frecvente
1Greșeală de tastare în tipul obiectului
kubectl scale deploymnet catalog --replicas=3kubectl scale deployment catalog --replicas=3deploymnet nu e un nume cunoscut. deployment, deployments și deploy sunt toate acceptate.
2Nume de tip tradus sau inventat
kubectl get poduri
kubectl get serviciikubectl get pods
kubectl get services # sau svcNumele tipurilor sunt cele din API, în engleză. kubectl api-resources le listează pe toate.
3Tipul vine dintr-un CRD neinstalat
kubectl get certificateskubectl api-resources | grep -i cert
# instalează operatorul care aduce CRD-ulTipurile personalizate există doar după ce instalezi CRD-ul lor. Fără el, serverul nu le cunoaște.
Repară eroarea, direct în pagină
Un coleg a încercat să scaleze Deploymentul catalog al unei librării online la 3 replici cu kubectl scale deploymnet catalog --replicas=3 și a primit the server doesn't have a resource type. Scalează corect Deploymentul la 3 replici și verifică faptul că toate podurile pornesc.
Indiciu
Tipul este deployment (sau prescurtat deploy).
Reparația
Comanda greșită:
kubectl scale deploymnet catalog --replicas=3 || trueerror: the server doesn't have a resource type "deploymnet"Cu tipul corect:
kubectl scale deployment catalog --replicas=3
kubectl rollout status deployment/catalog
kubectl get deploy catalogdeployment.apps/catalog scaled
Waiting for deployment "catalog" rollout to finish: 1 of 3 updated replicas are available...
Waiting for deployment "catalog" rollout to finish: 2 of 3 updated replicas are available...
deployment "catalog" successfully rolled out
NAME READY UP-TO-DATE AVAILABLE AGE
catalog 3/3 3 3 30sDe ce merge
kubectl caută tipul scris în lista de resurse pe care o publică API server-ul. deploymnet nu există acolo, deci comanda se oprește înainte să atingă Deploymentul. Cu numele corect, kubectl scale modifică spec.replicas, iar controllerul creează podurile lipsă. Formele scurte (deploy, po, svc) reduc greșelile de tastare.
Alte forme ale mesajului
error: the server doesn't have a resource type "poduri"error: the server doesn't have a resource type "certificates"
Cum o eviți pe viitor
- Folosește formele scurte, greu de greșit:
po,deploy,svc,cm,ns,pvc,ing. - Activează autocompletarea kubectl (
source <(kubectl completion bash)): tipurile și numele se completează cu Tab. - Când lucrezi cu un operator, verifică întâi cu
kubectl api-resources | grep numecă CRD-urile lui sunt instalate.
Întrebări frecvente
De ce merge kubectl get deploy, dar nu kubectl get deploys?
kubectl acceptă trei forme pentru fiecare tip: pluralul (deployments), singularul (deployment) și numele scurte declarate (deploy). deploys nu e niciuna dintre ele.
Contează literele mari?
kubectl acceptă și Deployment sau Pod (după Kind), dar convenția e să scrii cu litere mici. Problema din mesaj e aproape mereu o literă greșită, nu majuscula.
Erori înrudite
error: unknown flag: --raplicas Comanda kubectl nu are opțiunea scrisă: e o greșeală de tastare (--raplicas, --replica) sau opțiunea aparține altei comenzi. Verifică numele cu kubectl <comandă> --help și scrie-l exact, de exemplu --replicas=3. Error from server (NotFound): pods "web" not found Nu există niciun pod cu numele acesta în namespace-ul în care caută kubectl. De obicei podul e în alt namespace (adaugă -n sau schimbă contextul) sau ai dat numele Deploymentului în loc de numele podului, care are un sufix generat (web-7c9f8d-x2kq). 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. Î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.
