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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În versiunile vechi (extensions/v1beta1), selectorul unui Deployment se deducea din etichetele șablonului. Din apps/v1 trebuie scris explicit, iar API server-ul respinge manifestul fără el. Mesajul spune calea exactă a câmpului lipsă: spec.selector.
De obicei apare la manifeste scrise de mână după un tutorial vechi, la copierea unui Pod în interiorul unui Deployment sau când indentarea greșită a mutat selector în alt loc (de exemplu sub template), unde e ignorat ca necunoscut sau dă altă eroare.
Selectorul trebuie să se potrivească cu etichetele șablonului, altfel urmează eroarea selector does not match template labels.
De ce apare: cauzele frecvente
1Selector lipsă
spec:
replicas: 2
template:
metadata:
labels:
app: webspec:
replicas: 2
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: webapps/v1 cere selectorul explicit.
2Selector pus în locul greșit
template:
selector:
matchLabels:
app: web selector:
matchLabels:
app: web
template:selector aparține de spec, la același nivel cu template și replicas.
Repară eroarea, direct în pagină
Manifestul ~/k8s/web.yaml al unui blog culinar, scris după un tutorial vechi, nu are selector, iar kubectl apply dă spec.selector: Required value. Adaugă selectorul matchLabels: app: web sub spec și aplică fișierul.
Indiciu
selector stă sub spec, la același nivel cu replicas și template.
Reparația
Validarea eșuează:
kubectl apply -f web.yaml || trueError from server (Invalid): error when creating "web.yaml": The Deployment "web" is invalid: spec.selector: Required valueAdaugă selectorul și aplică:
Fișierul web.yaml:
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 2
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: web
image: nginx:1.27
ports:
- containerPort: 80kubectl 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
În apps/v1, Deploymentul trebuie să spună explicit după ce etichete își recunoaște podurile. Selectorul adăugat (app: web) se potrivește cu eticheta din șablon, deci API server-ul acceptă manifestul. Indentarea contează: selector e copilul lui spec, nu al lui template.
Alte forme ale mesajului
The StatefulSet "db" is invalid: spec.selector: Required valueerror validating data: ValidationError(Deployment.spec): missing required field "selector" in io.k8s.api.apps.v1.DeploymentSpec
Cum o eviți pe viitor
- Pornește de la un schelet generat:
kubectl create deployment web --image=nginx:1.27 --dry-run=client -o yaml. - Verifică structura cu
kubectl explain deployment.speccând nu știi unde stă un câmp. - Validează fișierul cu
kubectl apply --dry-run=server -fînainte să-l pui în git.
Întrebări frecvente
De ce tutorialele vechi nu au selector?
Pentru că foloseau extensions/v1beta1 sau apps/v1beta1, unde selectorul era opțional. Aceste versiuni au fost scoase în Kubernetes 1.16.
Ce câmpuri sunt obligatorii într-un Deployment?
apiVersion, kind, metadata.name, spec.selector, spec.template cu etichete și cel puțin un container cu name și image.
Erori înrudite
The Deployment "web" is invalid: spec.template.metadata.labels: Invalid value: map[string]string{"app":"site"}: `selector` does not match template `labels` Selectorul Deploymentului (spec.selector.matchLabels) cere alte etichete decât cele puse pe poduri în spec.template.metadata.labels. Fă-le identice (de exemplu app: web în ambele locuri) și aplică din nou. 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. The Pod "p" is invalid: spec.containers[0].name: Required value Containerul nu are câmpul name, obligatoriu pentru fiecare container. Adaugă - name: web (litere mici, cifre, -) la începutul containerului și aplică din nou. Î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.
