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
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
helm install m academia/magazin --set replicaCount=doshelm install m academia/magazin --set replicaCount=2replicas e un număr întreg.
2Ghilimele în fișierul de valori
replicaCount: "2"replicaCount: 2Între ghilimele, valoarea devine text.
3Tag numeric
--set image.tag=1.10--set-string image.tag=1.10--set-string păstrează valoarea ca text.
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.
Reparația
Valoarea text:
helm install libreria academia/magazin --set replicaCount=dos || true
helm list -aError: 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
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
libreria default 1 2026-01-15 10:00:04.123460789 +0200 EET failed magazin-0.2.0 v1Număr:
helm uninstall libreria 2>/dev/null || true
helm install libreria academia/magazin --set replicaCount=2
helm get values libreriarelease "libreria" uninstalled
NAME: libreria
LAST DEPLOYED: Thu Jan 15 10:00:10 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Magazinul a fost instalat ca release-ul libreria în namespace-ul default.
Ca să-l vezi în browser:
kubectl port-forward svc/libreria-magazin 8080:80
apoi deschide http://localhost:8080
USER-SUPPLIED VALUES:
replicaCount: 2De ce merge
dos a ajuns ca text în spec.replicas, care cere un număr întreg, deci API server-ul a refuzat Deploymentul. Cu --set replicaCount=2, Helm transmite numărul 2, Deploymentul e acceptat, iar release-ul pornește cu două poduri ale magazinului.
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-stringpentru taguri și versiuni. - Documentează tipul fiecărei valori în
values.yaml(comentarii sauvalues.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
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. Error: INSTALLATION FAILED: open valori.yaml: no such file or directory Fișierul de valori dat cu -f nu există la calea indicată, relativ la folderul curent. Verifică numele și folderul (ls) sau dă calea completă. Error: INSTALLATION FAILED: parse error at (graf/templates/deployment.yaml:9): unexpected "}" in operand Un șablon Go din chart are o acoladă greșită: o acțiune deschisă cu {{ se închide cu o singură }. Mesajul arată fișierul și linia; închide acțiunea cu }} și verifică cu helm lint sau helm template. Î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.
