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

error: error parsing web.yaml: error converting YAML to JSON: yaml: line 8: found character that cannot start any token

Pe scurt

Pe linia indicată e un caracter pe care YAML nu îl acceptă la început de valoare, aproape mereu un TAB folosit la indentare (YAML acceptă doar spații) sau un caracter special (@, `, %) fără ghilimele. Înlocuiește tab-urile cu spații și pune valorile speciale între ghilimele.

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

Ce înseamnă

Parserul YAML citește fiecare element începând cu primul caracter. Unele caractere nu pot deschide o valoare: tab-ul (YAML interzice tab-urile la indentare), backtick-ul, @ și % la început de valoare. Când dă peste unul, se oprește cu acest mesaj și numărul liniei.

Cel mai des vine dintr-un editor care pune tab-uri la apăsarea tastei Tab, din cod copiat dintr-o pagină web sau dintr-un fișier Makefile. Tab-ul nu se vede: arată ca niște spații. cat -A fișier afișează tab-urile ca ^I, iar grep -P '\t' fișier le găsește.

Pentru valori care încep cu @ (de exemplu un utilizator @admin), pune ghilimele.

De ce apare: cauzele frecvente

1Tab la indentare

Greșit
YAML
  - name: p
	image: nginx:1.27
Corect
YAML
  - name: p
    image: nginx:1.27

YAML acceptă doar spații pentru indentare.

2Valoare care începe cu @

Greșit
YAML
      value: @admin
Corect
YAML
      value: "@admin"

@ e rezervat în YAML; între ghilimele devine text obișnuit.

3Backtick copiat din documentație

Greșit
YAML
    image: `nginx:1.27`
Corect
YAML
    image: nginx:1.27

Backtick-urile din documentație marchează codul, nu fac parte din valoare.

Repară tu

Repară eroarea, direct în pagină

Manifestul ~/k8s/web.yaml al unui atelier de biciclete a fost editat într-un editor care pune tab-uri, iar kubectl apply dă found character that cannot start any token. Înlocuiește tab-ul cu spații, ca image să fie aliniat sub name, și aplică fișierul.

Indiciu

cat -A web.yaml arată tab-urile ca ^I.

Alte forme ale mesajului

  • yaml: line 6: found character that cannot start any token
  • error converting YAML to JSON: yaml: line 3: found a tab character that violates indentation

Cum o eviți pe viitor

  • Configurează editorul să insereze spații la Tab pentru fișierele .yaml (în VS Code e implicit).
  • Activează afișarea caracterelor invizibile când lucrezi cu YAML.
  • Rulează yamllint înainte de commit: găsește tab-urile și indentările inconsecvente.
  • Nu copia YAML din pagini web fără să verifici după aceea caracterele invizibile.

Întrebări frecvente

Cum găsesc tab-urile într-un fișier?

Cu cat -A fișier (tab-urile apar ca ^I) sau cu grep -n -P '\t' fișier, care afișează și numărul liniei.

Pot înlocui toate tab-urile deodată?

Da: sed -i 's/\t/ /g' fișier le înlocuiește cu câte două spații. Verifică apoi alinierea, pentru că un tab poate valora altă lățime în editorul tău.

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.