...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

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

Pe scurt

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

Greșit
YAML
    ports:
    - containerPort: "8080"
Corect
YAML
    ports:
    - containerPort: 8080

Fără ghilimele, YAML citește valoarea ca număr.

2Replicas din șablon cu quote

Greșit
YAML
  replicas: {{ .Values.replicas | quote }}
Corect
YAML
  replicas: {{ .Values.replicas }}

quote transformă numărul în șir.

3Nume de port în locul numărului

Greșit
YAML
    - containerPort: http
Corect
YAML
    - name: http
      containerPort: 8080

containerPort cere numărul; numele se pune în câmpul name.

Repară tu

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.

Alte forme ale mesajului

  • json: cannot unmarshal string into Go struct field DeploymentSpec.spec.replicas of type int32
  • json: 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 quote doar 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

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