Error: INSTALLATION FAILED: YAML parse error on graf/templates/deployment.yaml: error converting YAML to JSON: yaml: line 13: mapping values are not allowed in this context
Șablonul s-a randat, dar rezultatul nu e YAML valid, de obicei din cauza indentării. Numărul liniei se referă la YAML-ul generat, nu la fișierul șablonului: vezi rezultatul cu helm template --debug sau helm template -s templates/deployment.yaml și corectează indentarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Helm lucrează în doi pași: randează șabloanele Go în text, apoi interpretează textul ca YAML. Eroarea aceasta vine din al doilea pas: textul generat are o greșeală de YAML, cel mai des o indentare greșită, un nindent cu numărul greșit de spații sau o valoare cu : neîncadrată de ghilimele.
Atenție: line 13 e linia din YAML-ul generat, nu din fișierul șablonului, pentru că liniile cu {{- ... }} dispar la randare. helm template NUME ./chart -s templates/deployment.yaml afișează exact textul generat, iar --debug îl arată chiar și când e invalid.
Compară indentarea cu un fișier funcțional (de exemplu cel creat de helm create).
De ce apare: cauzele frecvente
1Indentare greșită
spec:
replicas: {{ .Values.replicaCount }}
selector:spec:
replicas: {{ .Values.replicaCount }}
selector:Cheile surori trebuie să aibă aceeași indentare.
2nindent greșit
labels:
{{- include "graf.labels" . | nindent 2 }} labels:
{{- include "graf.labels" . | nindent 4 }}nindent trebuie să corespundă nivelului din YAML.
3Valoare cu două puncte
descriere: {{ .Values.descriere }} # "ora: 10" descriere: {{ .Values.descriere | quote }}quote pune valoarea între ghilimele.
Repară eroarea, direct în pagină
În chartul local graf3 al unei aplicații de sondaje, cineva a mutat linia replicas: din deployment.yaml cu un spațiu în plus, iar helm install graf3 ./graf3 dă YAML parse error. Readu indentarea la 2 spații și instalează release-ul graf3.
Indiciu
grep -n 'replicas:' graf3/templates/deployment.yaml arată linia.
Reparația
Eroarea și linia:
helm install graf3 ./graf3 || true
grep -n 'replicas:' graf3/templates/deployment.yamlError: INSTALLATION FAILED: YAML parse error on graf3/templates/deployment.yaml: error converting YAML to JSON: yaml: line 13: mapping values are not allowed in this context
9: replicas: {{ .Values.replicaCount }}Indentarea corectă:
sed -i 's/^ replicas:/ replicas:/' graf3/templates/deployment.yaml
helm template graf3 ./graf3 -s templates/deployment.yaml | head -12
helm install graf3 ./graf3---
# Source: graf3/templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: graf3
labels:
helm.sh/chart: graf3-0.1.0
app.kubernetes.io/name: graf3
app.kubernetes.io/instance: graf3
app.kubernetes.io/version: "1.16.0"
app.kubernetes.io/managed-by: Helm
NAME: graf3
LAST DEPLOYED: Thu Jan 15 10:00:14 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
1. Get the application URL by running these commands:
kubectl --namespace default port-forward svc/graf3 8080:80
echo "Visit http://127.0.0.1:8080 to use your application"De ce merge
Cu 3 spații, replicas nu mai era la același nivel cu selector, deci YAML-ul generat era invalid, chiar dacă șablonul Go era corect. Readusă la 2 spații, cheia stă din nou sub spec, iar YAML-ul se parsează și release-ul graf3 se instalează.
Alte forme ale mesajului
Error: YAML parse error on graf/templates/service.yaml: error converting YAML to JSON: yaml: line 8: did not find expected key
Cum o eviți pe viitor
- Rulează
helm templatedupă fiecare schimbare și citește rezultatul. - Folosește
nindentcu numărul de spații al nivelului în care inserezi. - Pune
| quotela valorile text care pot conține caractere speciale. - Adaugă
helm lintîn pipeline. - Compară indentarea cu fișierele generate de
helm create, care sunt corecte.
Întrebări frecvente
De ce linia din mesaj nu corespunde fișierului?
Pentru că e linia din YAML-ul generat. Liniile de șablon dispar sau se extind la randare.
Cum văd YAML-ul invalid?
helm template NUME ./chart --debug îl afișează chiar dacă parsarea eșuează.
Erori înrudite
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. 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: error parsing web.yaml: error converting YAML to JSON: yaml: line 9: did not find expected '-' indicator Un element dintr-o listă YAML nu e aliniat: parserul aștepta un nou element care începe cu - sau o cheie la același nivel, dar a găsit altă indentare. Aliniază câmpurile containerului (name, image, ports) exact unul sub altul. Î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.
