Error from server (BadRequest): error when creating "web.yaml": Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal string into Go struct field ContainerPort.spec.containers.ports.containerPort of type int32
Un câmp numeric din manifest a primit text: de obicei un port între ghilimele ("8080") sau un nume (http). Scrie numărul fără ghilimele: containerPort: 8080.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Kubernetes e scris în Go și fiecare câmp are un tip fix. containerPort, replicas, port sunt numere întregi (int32). Dacă în YAML scrii valoarea între ghilimele, ea devine șir de caractere, iar decodarea JSON de pe server eșuează. Mesajul spune tipul primit (string), câmpul (ContainerPort...containerPort) și tipul așteptat (int32).
Cauze frecvente: ghilimele puse „din obișnuință” (containerPort: "8080"), valori venite din șabloane Helm cu quote, sau un nume de port (http) pus într-un câmp care cere număr.
Atenție la câmpurile care acceptă ambele forme: targetPort dintr-un Service și port dintr-o probă acceptă și număr, și nume de port.
De ce apare: cauzele frecvente
1Port între ghilimele
ports:
- containerPort: "8080" ports:
- containerPort: 8080Fără ghilimele, YAML citește valoarea ca număr.
2Replicas din șablon cu quote
replicas: {{ .Values.replicas | quote }} replicas: {{ .Values.replicas }}quote transformă numărul în șir.
3Nume de port în locul numărului
- containerPort: http - name: http
containerPort: 8080containerPort cere numărul; numele se pune în câmpul name.
Repară eroarea, direct în pagină
Podul api al unei aplicații de rezervări are în ~/k8s/api.yaml portul scris containerPort: "3000", iar kubectl apply dă cannot unmarshal string into ... of type int32. Repară tipul valorii și aplică fișierul.
Indiciu
Un număr fără ghilimele rămâne număr în YAML.
Reparația
Serverul respinge valoarea:
kubectl apply -f api.yaml || trueError from server (BadRequest): error when creating "api.yaml": Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal string into Go struct field ContainerPort.spec.containers.ports.containerPort of type int32Scoate ghilimelele și aplică:
sed -i 's/containerPort: "3000"/containerPort: 3000/' api.yaml
kubectl apply -f api.yaml
kubectl get pod apipod/api created
NAME READY STATUS RESTARTS AGE
api 0/1 ContainerCreating 0 2sDe ce merge
containerPort e un întreg în API. Între ghilimele, YAML transformă valoarea în șir, iar serverul nu poate pune un șir într-un câmp numeric. Fără ghilimele, 3000 e citit ca număr și podul se creează. Dacă vrei să dai un nume portului, folosește câmpul separat name.
Alte forme ale mesajului
json: cannot unmarshal string into Go struct field DeploymentSpec.spec.replicas of type int32json: cannot unmarshal string into Go struct field ServicePort.spec.ports.port of type int32
Cum o eviți pe viitor
- Scrie numerele din manifeste fără ghilimele; ghilimelele sunt pentru text.
- În șabloanele Helm folosește
quotedoar pentru valorile text (variabile de mediu, adnotări). - Verifică tipul unui câmp cu
kubectl explain pod.spec.containers.ports.containerPort. - Dă nume porturilor (
name: http) și folosește numele în Service și probe, ca numărul să apară într-un singur loc.
Întrebări frecvente
De ce la variabile de mediu e invers?
Pentru că env[].value e de tip șir. Acolo numerele și true trebuie puse între ghilimele, altfel primești eroarea opusă: cannot unmarshal number into ... of type string.
Unde pot folosi nume de port?
În targetPort la Service și în probe (port: http), dacă portul containerului are acel name. containerPort însuși trebuie să fie număr.
Erori înrudite
json: cannot unmarshal bool into Go struct field EnvVar.spec.containers.env.value of type string Valoarea unei variabile de mediu trebuie să fie text, dar în YAML ai scris true, false sau un număr fără ghilimele. Pune valoarea între ghilimele: value: "true", value: "8080". Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal object into Go struct field PodSpec.spec.containers of type array Un câmp care trebuie să fie listă (containers, ports, env, volumes) a fost scris ca obiect, fără liniuța - în fața elementului. Adaugă - la primul câmp al fiecărui element: - name: 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. Î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.
