...
Eroare Kubernetes · kubectl, kubeconfig și conexiunea la cluster

error: the server doesn't have a resource type "deploymnet"

Pe scurt

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

Greșit
YAML
kubectl scale deploymnet catalog --replicas=3
Corect
YAML
kubectl scale deployment catalog --replicas=3

deploymnet nu e un nume cunoscut. deployment, deployments și deploy sunt toate acceptate.

2Nume de tip tradus sau inventat

Greșit
YAML
kubectl get poduri
kubectl get servicii
Corect
YAML
kubectl get pods
kubectl get services   # sau svc

Numele tipurilor sunt cele din API, în engleză. kubectl api-resources le listează pe toate.

3Tipul vine dintr-un CRD neinstalat

Greșit
YAML
kubectl get certificates
Corect
YAML
kubectl api-resources | grep -i cert
# instalează operatorul care aduce CRD-ul

Tipurile personalizate există doar după ce instalezi CRD-ul lor. Fără el, serverul nu le cunoaște.

Repară tu

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

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 nume că 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

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