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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În API-ul Kubernetes, env[].value este întotdeauna un șir de caractere, pentru că variabilele de mediu sunt text pentru sistemul de operare. YAML însă interpretează automat true, false, yes, no ca booleeni și 8080, 0.5 ca numere. Serverul primește atunci un bool sau un number acolo unde așteaptă string și refuză podul.
Mesajul spune ce tip a primit (bool, number) și calea câmpului. Aceeași problemă apare în ConfigMap-uri (data cere tot șiruri) și în adnotări.
Soluția e simplă: ghilimele în jurul valorii. Aplicația primește oricum text și își face singură conversia.
De ce apare: cauzele frecvente
1Boolean fără ghilimele
env:
- name: DEBUG
value: true env:
- name: DEBUG
value: "true"Ghilimelele fac din true un șir.
2Număr fără ghilimele
- name: PORT
value: 8080 - name: PORT
value: "8080"Și numerele trebuie date ca text în env.
3ConfigMap cu valoare numerică
data:
MAX_CONEXIUNI: 50data:
MAX_CONEXIUNI: "50"Valorile din data unui ConfigMap sunt tot șiruri.
Repară eroarea, direct în pagină
Podul magazin din ~/k8s/magazin.yaml (magazinul online al unei ceainării) are variabila DEBUG cu valoarea true scrisă fără ghilimele, iar kubectl apply dă cannot unmarshal bool into ... of type string. Repară valoarea, aplică fișierul și verifică variabila în container.
Indiciu
Variabilele de mediu sunt mereu text.
Reparația
Serverul respinge tipul:
kubectl apply -f magazin.yaml || trueError from server (BadRequest): error when creating "magazin.yaml": Pod in version "v1" cannot be handled as a Pod: json: cannot unmarshal bool into Go struct field EnvVar.spec.containers.env.value of type stringValoarea între ghilimele:
sed -i 's/value: true/value: "true"/' magazin.yaml
kubectl apply -f magazin.yaml
kubectl wait --for=condition=Ready pod/magazin
kubectl exec magazin -- printenv DEBUGpod/magazin created
pod/magazin condition met
trueDe ce merge
YAML transformă true fără ghilimele în boolean, dar env[].value e un șir în API-ul Kubernetes, deci serverul respinge podul. Cu "true", valoarea rămâne text, exact ce primește procesul în mediul lui. Aplicația o interpretează apoi cum vrea ea.
Alte forme ale mesajului
json: cannot unmarshal number into Go struct field EnvVar.spec.containers.env.value of type stringConfigMap in version "v1" cannot be handled as a ConfigMap: json: cannot unmarshal number into Go struct field ConfigMap.data of type string
Cum o eviți pe viitor
- Pune între ghilimele toate valorile din
envși dindataale ConfigMap-urilor, indiferent ce par. - În Helm, folosește
{{ .Values.x | quote }}pentru variabilele de mediu. - Atenție la
yes/no/on/off: unele parsere YAML le transformă tot în booleeni.
Întrebări frecvente
De ce replicas: 3 merge fără ghilimele, iar value: 3 nu?
Pentru că replicas e număr în API, iar env.value e text. Tipul e decis de câmp, nu de valoare.
Aplicația mea citește DEBUG ca boolean. Contează?
Nu. Procesul primește oricum textul true din mediu; conversia o face aplicația, la fel ca pentru orice variabilă de mediu.
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: error parsing web.yaml: error converting YAML to JSON: yaml: line 11: mapping values are not allowed in this context YAML-ul are pe linia indicată un : nepermis: de obicei o valoare care conține „: ” fără ghilimele (Luni-Vineri: 9-18) sau o indentare greșită. Pune valoarea între ghilimele sau corectează indentarea și aplică din nou. Error: couldn't find key PROGRAM in ConfigMap default/setari ConfigMap-ul există, dar nu are cheia cerută de configMapKeyRef (aici PROGRAM). Adaugă cheia în ConfigMap sau corectează numele cheii din pod (contează literele mari și mici). Î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.
