YAML in JSON

Raccomandazioni correlate

Informazioni su YAML in JSON: converti la configurazione YAML in oggetti JSON standard automaticamente

Casi d'uso

• Converti i manifest di Kubernetes, i valori dei chart Helm e altri file di configurazione K8s in JSON per l'uso con kubectl apply --validate o query jq, unioni e iniezione in pipeline CI/CD.
• Converti i file Docker Compose (docker-compose.yml) in JSON per distribuirli su cluster Swarm con docker stack deploy, o importarli in altri strumenti di orchestrazione di container.
• Converti le pipeline CI/CD di GitHub Actions, GitLab CI, CircleCI (.github/workflows/*.yml) in JSON per un confronto delle versioni e un'elaborazione dei template più semplici.
• Converti i playbook Ansible (playbook.yml, hosts, roles) in JSON per l'elaborazione programmatica con caricatori di configurazione Python o Node.js.
• Converti le regole di allerta Prometheus, la configurazione di Alertmanager, la configurazione di Promtail/Grafana Loki in JSON per la generazione e i test dinamici.
• Converti i file di configurazione degli strumenti frontend (ESLint, Prettier, Stylelint, Commitlint, .eslintrc, .prettierrc) in JSON per plugin IDE ed editor.
• Converti i file YAML di specifica swagger/openapi in JSON, con swagger-codegen o openapi-generator per generare SDK client o codice stub del server.
• Insegna la relazione di conversione tra YAML e JSON, confrontando differenze di sintassi, regole di rientro, gestione dei commenti e mappatura dei tipi.

Come utilizzare

1. Incolla il tuo YAML nell'editor di sinistra, fai clic su Carica per selezionare un file .yaml/.yml/.txt, o fai clic su Esempio per caricare l'esempio di configurazione utente integrato.
2. Lo strumento converte automaticamente 400ms dopo l'interruzione della digitazione. Visualizza il JSON convertito a destra con l'evidenziazione della sintassi CodeMirror.
3. Fai clic sulla casella di controllo 'Formatta output' nella barra degli strumenti inferiore per alternare tra le modalità di output pretty (rientro di 2 spazi) e compatto in tempo reale.
4. Se YAML presenta errori di sintassi, fai clic sul pulsante Ripara struttura accanto al messaggio di errore. Lo strumento chiama tryFixYAML per correggere automaticamente 5 errori comuni e indica quali righe sono state corrette.
5. Fai clic su Copia per mettere il JSON negli appunti, o fai clic su Scarica per salvarlo come file converted.json (MIME: application/json).
6. Incolla il JSON nel tuo codice di destinazione (kubectl apply, swagger-codegen, caricatore di configurazione Node.js personalizzato, ecc.) o importalo nel tuo servizio backend per l'ulteriore elaborazione.

Funzionalità

• Analisi della libreria js-yaml: basata sulla matura libreria js-yaml che supporta tutta la sintassi YAML 1.1 standard (scalari, sequenze, mappature, ancore, alias, stringhe multiriga, ecc.), senza dipendenze.
• Riparazione intelligente degli errori: tryFixYAML integrato corregge automaticamente 5 errori YAML comuni (tabulazioni, virgolette non chiuse, rientro irregolare, chiavi con caratteri speciali, spazi finali).
• Modalità di output pretty: rientro predefinito di 2 spazi per output leggibile; la modalità non-pretty genera JSON compatto su una sola riga per la trasmissione di rete.
• Supporto completo dei tipi: supporta tutti i tipi scalari YAML (stringa, numero, booleano, null, data), sequenze (array), mappature (oggetto) in entrambe le direzioni.
• Strutture annidate ricorsive: mappature e sequenze YAML annidate di qualsiasi profondità vengono convertite ricorsivamente in oggetti e array JSON annidati corrispondenti.
• Risoluzione di ancoraggi e alias: supporta ancoraggi YAML (&anchor) e alias (*alias), js-yaml risolve automaticamente le relazioni di riferimento, il JSON mostra il contenuto espanso.
• Commento YAML ignorato: i commenti YAML (#) vengono automaticamente ignorati, il JSON convertito sono dati puri, senza commenti.
• Conversione automatica in tempo reale: conversione 400ms dopo l'interruzione della digitazione, combinata con scorciatoie da tastiera per maggiore efficienza.
• Evidenziazione della sintassi JSON: il lato destro utilizza l'evidenziazione della sintassi JSON di CodeMirror per facilitare la lettura di strutture JSON complesse.
• 100% nel browser: tutta l'analisi YAML, la serializzazione JSON e la riparazione degli errori avvengono in JavaScript lato client; la configurazione originale non viene caricata.
• Recupero della cronologia: salva automaticamente le ultime 200 voci della cronologia e ripristina l'input precedente al caricamento della pagina.
• Sistema completo di scorciatoie: converti, carica, copia, scarica, cancella operazioni comuni, seguendo le convenzioni dei principali editor JSON/YAML.

Domande frequenti

Risoluzione dei problemi

Glossario

YAML (YAML Ain't Markup Language)

Formato di serializzazione dei dati adatto all'utente umano, progettato nel 2001 da Clark Evans e altri. Usa il rientro per la gerarchia, supporta commenti, elenchi, mappature, stringhe multiriga, ancore e alias. È lo standard di configurazione de facto per Kubernetes, Docker Compose, Ansible, GitHub Actions e altri strumenti DevOps moderni.

JSON (JavaScript Object Notation)

Formato leggero di scambio dati basato sulla sintassi degli oggetti JavaScript, ma indipendente da qualsiasi linguaggio di programmazione. Supporta sei tipi di base: oggetto ({}), array ([]), stringa, numero, booleano e null. È lo standard de facto per le API web moderne, i database NoSQL e l'ecosistema JavaScript.

js-yaml

Parser e serializzatore YAML JavaScript maturo (~50KB) che supporta la specifica YAML 1.1 completa e parti della 1.2. Lo strumento utilizza questa libreria per analizzare YAML in oggetti JavaScript e quindi serializzare in JSON tramite JSON.stringify.

Rientro

YAML utilizza rigorosamente il rientro per esprimere la gerarchia. Deve usare spazi (non tabulazioni) e il rientro deve essere coerente (come 2 spazi). Questa è una delle fonti di errori YAML più comuni. Lo strumento rileva e corregge automaticamente i problemi di rientro.

Ancoraggi e alias (& *)

Caratteristiche YAML avanzate. &anchor definisce un'etichetta che può essere referenziata; *alias referenzia l'etichetta. js-yaml espande automaticamente i riferimenti durante l'analisi interna, quindi il JSON finale non conserva queste etichette, solo i dati espansi.

Stringhe multiriga

YAML fornisce due sintassi per le stringhe multiriga. Il blocco letterale (|) preserva le interruzioni di riga; il blocco piegato (>) ripiega le interruzioni di riga in spazi semplici. js-yaml analizza correttamente entrambe le sintassi e converte in JSON preservando o ripiegando le interruzioni di riga secondo la specifica.

Separatore di documento (---)

Tre trattini consecutivi (---) in YAML denotano separatori di documento, spesso utilizzati per includere più documenti YAML in un file. js-yaml per impostazione predefinita analizza solo il primo documento; l'analisi multi-documento richiede una gestione speciale.

YAML 1.1 vs 1.2

YAML 1.1 (2005) è ampiamente distribuito, supporta numeri ottali, singolo carattere di genere, abbreviazione Norvegia, ecc. YAML 1.2 (2009) ha rimosso le caratteristiche ambigue, più compatibile con JSON. Lo strumento utilizza YAML 1.1 per impostazione predefinita per la massima compatibilità.

Ancora (&)

In YAML, &name definisce un'etichetta che può essere referenziata da *name più tardi, spesso utilizzata per evitare di ripetere lo stesso blocco di configurazione in più documenti.

Alias (*)

In YAML, *name referenzia un'etichetta precedentemente definita con &name; js-yaml sostituisce il riferimento con il contenuto effettivo durante l'analisi, quindi il JSON finale non contiene informazioni sull'alias.

JSON.stringify

Metodo integrato JavaScript per serializzare un oggetto in una stringa JSON. Lo strumento utilizza il secondo parametro (replacer) e il terzo parametro (space) per controllare il rientro: space=2 genera output pretty, space=undefined genera una singola riga compatta.

tryFixYAML

Funzione di riparazione YAML integrata nello strumento che rileva e corregge automaticamente 5 errori comuni: tabulazioni in spazi, rimozione di spazi bianchi finali, chiusura di virgolette non chiuse, correzione del rientro non multiplo di 2, e aggiunta di virgoletti a chiavi con caratteri speciali.

Output pretty

Modalità di output commutabile dello strumento. Quando abilitata, genera JSON con rientro di 2 spazi e interruzioni di riga (buono per la revisione umana); quando disabilitata, genera JSON compatto su una sola riga (buono per la trasmissione API, l'archiviazione).

Regole di mappatura dei tipi da YAML a JSON

Regole di conversione dello strumento basate su js-yaml:

Confronto di formato YAML vs JSON

Un confronto dei due formati in diverse dimensioni, che aiuta a capire quando scegliere YAML o JSON:

Errori e correzioni comuni di YAML

I 5 errori comuni di YAML che tryFixYAML dello strumento rileva e corregge automaticamente:

Privacy & Security

Questo strumento di conversione da YAML a JSON viene eseguito interamente nel tuo browser. L'analisi YAML (basata sulla matura libreria js-yaml), la serializzazione JSON e la riparazione degli errori (tryFixYAML) avvengono in JavaScript lato client; js-yaml è l'unica dipendenza esterna (un pacchetto npm di meno di 50 KB). I dati YAML originali (che possono contenere configurazioni sensibili come segreti k8s, chiavi API, credenziali del database) non vengono mai inviati a un server. I caricamenti di file utilizzano l'API FileReader nativa del browser e non passano mai attraverso un servizio intermedio. Lo strumento non utilizza cookie di tracciamento e non raccoglie dati di input o utilizzo. Tutti gli input e output vengono cancellati dalla memoria non appena la pagina viene chiusa o ricaricata. Sicuro da usare con file YAML contenenti configurazioni sensibili (segreti k8s, chiavi API, credenziali del database, pipeline DevOps aziendali).

Authoritative References

• YAML.orgSpecifica YAML 1.2
• GitHubRepository GitHub di js-yaml
• KubernetesRiferimento YAML di Kubernetes
• DockerSpecifica Docker Compose
• AnsibleGuida YAML di Ansible
• GitHubDocumentazione YAML di GitHub Actions