...
Eroare Kubernetes · Helm

Error: INSTALLATION FAILED: Deployment in version "v1" cannot be handled as a Deployment: json: cannot unmarshal string into Go struct field DeploymentSpec.spec.replicas of type int32

Pe scurt

O valoare dată chartului (cu --set sau -f) are alt tip decât cel cerut de câmpul Kubernetes: aici replicaCount a primit text în loc de număr. Dă un număr (--set replicaCount=2) și, pentru valori text care arată a număr, folosește --set-string.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Valorile unui chart ajung în șabloane, apoi în YAML-ul trimis la API server, care verifică tipul fiecărui câmp. spec.replicas e un număr întreg (int32), deci dacă replicaCount devine dos sau "2 replici", serverul refuză Deploymentul cu cannot unmarshal string into ... of type int32.

Cu --set, Helm ghicește tipul: 2 devine număr, true devine boolean, iar orice altceva devine text. Greșeli frecvente: un cuvânt în loc de număr, unități (replicaCount=2x), un fișier de valori cu "2" între ghilimele, sau invers, --set image.tag=1.0 care devine număr 1 când chartul aștepta text (pentru asta există --set-string).

Mesajul spune câmpul exact (spec.replicas) și tipul așteptat.

De ce apare: cauzele frecvente

1Text în loc de număr

Greșit
YAML
helm install m academia/magazin --set replicaCount=dos
Corect
YAML
helm install m academia/magazin --set replicaCount=2

replicas e un număr întreg.

2Ghilimele în fișierul de valori

Greșit
YAML
replicaCount: "2"
Corect
YAML
replicaCount: 2

Între ghilimele, valoarea devine text.

3Tag numeric

Greșit
YAML
--set image.tag=1.10
Corect
YAML
--set-string image.tag=1.10

--set-string păstrează valoarea ca text.

Repară tu

Repară eroarea, direct în pagină

Un coleg a instalat magazinul unei librării spaniole cu helm install libreria academia/magazin --set replicaCount=dos, iar instalarea a eșuat cu cannot unmarshal string. Instalează release-ul libreria cu 2 replici.

Indiciu

replicaCount e un număr.

Alte forme ale mesajului

  • json: cannot unmarshal number into Go struct field Container.spec.template.spec.containers.image of type string

Cum o eviți pe viitor

  • Verifică valorile cu helm template înainte de install.
  • Folosește --set-string pentru taguri și versiuni.
  • Documentează tipul fiecărei valori în values.yaml (comentarii sau values.schema.json).
  • Preferă fișiere de valori în locul multor --set.
  • Testează valorile noi cu helm install --dry-run înainte de livrare.

Întrebări frecvente

Ce e values.schema.json?

O schemă JSON în chart care validează tipurile valorilor înainte de randare, cu mesaje mai clare.

De ce eroarea vine de la Kubernetes, nu de la Helm?

Pentru că șablonul nu verifică tipurile. Abia API server-ul compară YAML-ul cu schema obiectului.

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.