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

json: cannot unmarshal bool into Go struct field EnvVar.spec.containers.env.value of type string

Pe scurt

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

Greșit
YAML
    env:
    - name: DEBUG
      value: true
Corect
YAML
    env:
    - name: DEBUG
      value: "true"

Ghilimelele fac din true un șir.

2Număr fără ghilimele

Greșit
YAML
    - name: PORT
      value: 8080
Corect
YAML
    - name: PORT
      value: "8080"

Și numerele trebuie date ca text în env.

3ConfigMap cu valoare numerică

Greșit
YAML
data:
  MAX_CONEXIUNI: 50
Corect
YAML
data:
  MAX_CONEXIUNI: "50"

Valorile din data unui ConfigMap sunt tot șiruri.

Repară tu

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.

Alte forme ale mesajului

  • json: cannot unmarshal number into Go struct field EnvVar.spec.containers.env.value of type string
  • ConfigMap 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 din data ale 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

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