Μετατροπέας YAML σε JSON

Επικολλήστε έγκυρο YAML — ένα manifest Kubernetes, αρχείο Compose, playbook Ansible, προδιαγραφή OpenAPI ή οποιοδήποτε έγγραφο YAML 1.2 — και ο μετατροπέας αποδίδει το αντίστοιχό του σε JSON σε πραγματικό χρόνο.

Η μετατροπή εκτελείται εξ ολοκλήρου στον browser σας χρησιμοποιώντας έναν parser YAML 1.2, στη συνέχεια διασχίζει το αναλυμένο δέντρο παράγοντας JSON μέσω του JSON.stringify (κατά ECMA-404 / RFC 8259).

Επιλέξτε το στυλ εξόδου σας:

• 2 κενών (προεπιλογή, ευανάγνωστο από ανθρώπους)
• 4 κενών (ορισμένες εταιρικές βάσεις κώδικα)
• συμπιεσμένο (APIs, payloads δικτύου)

Η έξοδος είναι έτοιμη για επικόλληση σε ένα αρχείο `.json` ή αποστολή μέσω σωλήνα (pipe) στο `kubectl apply -f -` (το οποίο δέχεται JSON μέσω stdin). Το δεξιό πλαίσιο δείχνει ζωντανά μετρήσεις byte και γραμμών, ώστε να μπορείτε να ελέγξετε το μέγεθος πριν κάνετε commit.

Η μετατροπή YAML σε JSON απαιτεί τρία βήματα:

• Βήμα 1: Επικολλήστε το YAML σας στον επεξεργαστή. Ο parser επικυρώνει καθώς πληκτρολογείτε — το μη έγκυρο YAML εμφανίζει το ακριβές σφάλμα ανάλυσης με γραμμή και στήλη.
• Βήμα 2: Η έξοδος JSON εμφανίζεται ζωντανά στο δεξιό πλαίσιο. Δεν απαιτείται κλικ σε κουμπί· κάθε πάτημα πλήκτρου επαναλαμβάνει την ανάλυση.
• Βήμα 3: Κάντε κλικ στην Αντιγραφή (πρόχειρο) ή Λήψη (αρχείο `.json`).

Για προγραμματιστικές ροές εργασίας, η ίδια λογική διατίθεται μέσω του τελικού σημείου `/api/calculate` — κάντε POST YAML σε αυτό και λάβετε το JSON στο σώμα της απάντησης.

Ασφάλεια αμφίδρομης μετατροπής: μετατρέψτε το JSON πίσω σε YAML με τον αντίστοιχο Μετατροπέα JSON σε YAML· το μοντέλο δεδομένων διατηρείται ακριβώς (τα σχόλια και τα άγκιστρα αφορούν αποκλειστικά το YAML και δεν επιβιώνουν στην αμφίδρομη μετατροπή).

Το YAML και το JSON αντιπροσωπεύουν το ίδιο μοντέλο δεδομένων — χάρτες (αντικείμενα), ακολουθίες (πίνακες) και τιμές scalar (συμβολοσειρά/αριθμός/bool/null) — αλλά με πολύ διαφορετική σύνταξη επιφάνειας.

Το YAML βασίζεται στις εσοχές: η ένθεση υποδηλώνεται με εσοχή 2 κενών, οι ακολουθίες χρησιμοποιούν το πρόθεμα `- ` και οι περισσότερες συμβολοσειρές δεν χρειάζονται εισαγωγικά. Το JSON είναι φορτωμένο με αγκύδες και εισαγωγικά: κάθε κλειδί παίρνει `"`, κάθε χάρτης παίρνει `{}`, κάθε πίνακας παίρνει `[]` και κάθε διαχωριστικό είναι ρητό (`:` και `,`).

Το YAML υποστηρίζει σχόλια (`#`), άγκιστρα και ψευδώνυμα για επαναχρησιμοποίηση (`&name` / `*name`), ροές πολλαπλών εγγράφων (`---`) και ρητές ετικέτες τύπου (`!!str`, `!!int`) — πλεονεκτήματα που το καθιστούν τη σωστή επιλογή για ρυθμίσεις υπό έλεγχο πηγαίου κώδικα. Το JSON αναλύεται 5–10 φορές πιο γρήγορα, δεν έχει καμία απολύτως αμφισημία και αποτελεί τη σωστή επιλογή για APIs και αποθήκευση.

Μετατρέψτε στα όρια: YAML για ανθρώπους, JSON για μηχανές.

Η βαθιά ένθεση είναι το σημείο όπου η μετατροπή YAML σε JSON λάμπει — η μη αυτόματη παρακολούθηση εσοχών σε 5+ επίπεδα είναι επιρρεπής σε σφάλματα. Ο μετατροπέας διασχίζει το αναλυμένο δέντρο YAML αναδρομικά.

• Για κάθε block map, τα κλειδιά εκπέμπονται με τη σειρά προέλευσης με σύνταξη JSON `"key": value`· οι ένθετες τιμές παίρνουν αγκύδες `{...}`.
• Για κάθε block sequence, τα στοιχεία εκπέμπονται ως πίνακες JSON `[...]`· τα ένθετα αντικείμενα κάτω από ένα `-` γίνονται στοιχεία πίνακα `{...}`.

Mικτές δομές — ακολουθίες χαρτών, χάρτες που περιέχουν ακολουθίες χαρτών, αναδρομικά — μετατρέπονται όλες σωστά. Το μέγιστο βάθος περιορίζεται μόνο από τη στοίβα κλήσεων του browser σας (~10.000+ πλαίσια στους σύγχρονους browsers, πολύ πέρα από οποιαδήποτε ρεαλιστική ρύθμιση).

Δοκιμάστε το με τα δικά σας δεδομένα: αναλύστε την έξοδο JSON πίσω σε YAML και βεβαιωθείτε για τη δομική ισότητα με την είσοδο.

Η χαλαρή εξαγωγή τύπων του YAML είναι η πηγή πολλών σφαλμάτων σε ρυθμίσεις πραγματικού κόσμου. Το YAML 1.2 (το σύγχρονο πρότυπο, στόχος αυτού του μετατροπέα) περιόρισε τους κανόνες για μεγαλύτερη ασφάλεια.

• Booleans: ΜΟΝΟ `true` και `false` (χωρίς διάκριση πεζών-κεφαλαίων). Το YAML 1.1 αντιμετώπιζε επίσης τα `yes`/`no`/`on`/`off` ως booleans, κάτι που διέκοπτε διάσημα ρυθμίσεις που περιείχαν τον κωδικό χώρας της Νορβηγίας `NO` (μετατράπηκε σιωπηρά σε `false`) — το «πρόβλημα της Νορβηγίας». Οι περισσότεροι σύγχρονοι parsers (js-yaml, PyYAML 6+, Snakeyaml) προεπιλέγουν τη συμπεριφορά 1.2.
• Null: Το `null`, το `~` ή μια κενή τιμή γίνονται όλα JSON null.
• Αριθμοί: τα πρότυπα ψηφίων που ταιριάζουν με τη σύνταξη ακεραίου/κινητής υποδιαστολής του JSON γίνονται αριθμοί JSON· όλα τα υπόλοιπα παραμένουν συμβολοσειρές.
• Συμβολοσειρές: οι τιμές με εισαγωγικά παραμένουν πάντα συμβολοσειρές· αριθμητικές συμβολοσειρές όπως ταχυδρομικοί κώδικες (`"01234"`) και ημερομηνίες ημερολογίου χρειάζονται εισαγωγικά στο YAML για να επιβιώσουν στη μετατροπή — όταν μια ρύθμιση περιέχει μια ημερομηνία που υπολογίσατε αρχικά, τυλίξτε την σε εισαγωγικά ώστε ο parser να τη διατηρήσει αυτούσια αντί να την εξαναγκάσει.

Ο μετατροπέας σέβεται αυστηρά αυτούς τους κανόνες.

Το Kubernetes αποδέχεται τόσο YAML όσο και JSON μέσω του API server, του kubectl και των βιβλιοθηκών πελάτη. Οι περισσότερες ομάδες διατηρούν αρχεία YAML στον έλεγχο πηγαίου κώδικα (τα PR ελέγχονται ευκολότερα), αλλά τροφοδοτούν με JSON τα προγραμματιστικά εργαλεία — προσαρμοσμένους ελεγκτές (controllers), αγωγούς GitOps, Helm post-renderers ή webhooks.

Επικολλήστε το manifest σας (Pod, Deployment, Service, ConfigMap κ.λπ.) και αντιγράφετε την έξοδο JSON. Ο μετατροπέας διατηρεί τις ιεραρχίες apiVersion, kind, metadata και spec στη σωστή σειρά πεδίων — το Kubernetes αναμένει κλειδιά camelCase παντού, οπότε αν μεταφέρετε πεδία από πηγή snake_case, ένας μετατροπέας πεζών-κεφαλαίων διορθώνει την ονομασία πριν την επικόλληση.

Επικυρώστε με `kubectl apply --dry-run=client -f -` (το οποίο αποδέχεται JSON στο stdin) πριν κάνετε commit. Για manifests πολλαπλών πόρων που χωρίζονται με `---`, χωρίστε τα πρώτα σε μεμονωμένα έγγραφα — το JSON δεν διαθέτει σύνταξη πολλαπλών εγγράφων.

Τρεις περιπτώσεις χρήσης υψηλού όγκου πέρα από το Kubernetes:

• Docker Compose: επικολλήστε ένα `docker-compose.yaml` και αντιγράψτε JSON για εργαλεία όπως το Kompose (μεταναστεύει Compose σε K8s), προσαρμοσμένους ορχηστρωτές ή προγραμματιστικούς μετασχηματισμούς ρυθμίσεων.
• Ansible: μετατρέψτε τα playbooks σε JSON για εργαλεία τεκμηρίωσης, προσαρμοσμένες ενσωματώσεις CI ή APIs REST/GraphQL που αποθηκεύουν ορισμούς playbook.
• Αγωγοί CI/CD: GitHub Actions (`.github/workflows/*.yml`), GitLab CI (`.gitlab-ci.yml`), CircleCI, Travis — μετατρέψτε οποιοδήποτε από αυτά σε JSON για αναλυτικά στοιχεία, προγραμματιστικές επεξεργασίες ή αρχειοθέτηση αρχείων καταγραφής (audit-log). Οι προγραμματισμένες ενεργοποιήσεις `cron` τους είναι καθορισμένες σε UTC, οπότε ένας μετατροπέας ζώνης ώρας σας αποτρέπει από το να διαβάσετε λανθασμένα πότε εκτελείται πραγματικά ένας αγωγός στην τοπική σας ώρα.

Σημείωση: Οι εκφράσεις Jinja2 (`{{ var }}`), η σύνταξη προτύπων Helm (`{{ .Values.x }}`) και παρόμοια πρότυπα παραμένουν ως απλές συμβολοσειρές (strings) στο JSON — δεν αξιολογούνται από τον μετατροπέα.

Οι προδιαγραφές OpenAPI 3.x συνήθως συντάσσονται σε YAML (είναι πιο αναγνώσιμες για δέντρα διαδρομών/παραμέτρων) αλλά καταναλώνονται ως JSON από παλαιότερα εργαλεία — παλιότερες εκδόσεις Swagger UI, ορισμένες επιχειρησιακές πύλες API (API gateways) και ορισμένες γεννήτριες κώδικα.

Επικολλήστε το `openapi.yaml` (ή `swagger.yaml`) σας και κατεβάστε το `openapi.json`. Ο μετατροπέας διατηρεί τους δείκτες `$ref` ακριβώς (χωρίς ανάλυση), τους ορισμούς σχημάτων, τα παραδείγματα αποκρίσεων και τα σχήματα ασφαλείας.

Μετά τη μετατροπή, επικυρώστε με τον επίσημο επικυρωτή OpenAPI (Spectral CLI, openapi-cli, swagger-cli) για να επιβεβαιώσετε τη συμμόρφωση του σχήματος. Πλλές ομάδες διατηρούν YAML στον έλεγχο πηγαίου κώδικα και παράγουν JSON κατά τον χρόνο δόμησης (build time) — τόσο το `swagger.yaml` όσο και το `swagger.json` είναι πλήρως ισοδύναμα για τους καταναλωτές API.

Έξι σφάλματα αντιπροσωπεύουν το 95% των αποτυχιών ανάλυσης YAML:

• Στηλοθέτες (tabs) οπουδήποτε στις εσοχές — το YAML απαγορεύει εντελώς τα tabs, ακόμη και ένας χαρακτήρας tab διακόπτει την ανάλυση.
• Ασυνεπείς εσοχές — τα κλειδιά αδελφών (sibling keys) πρέπει να ευθυγραμμίζονται ακριβώς στην ίδια στήλη.
• Κενό που λείπει μετά το `:` στους χάρτες — το `key:value` δεν είναι έγκυρο· το `key: value` είναι σωστό.
• Κενό που λείπει μετά το `-` στις ακολουθίες — το `-item` είναι μια συμβολοσειρά που ξεκινά με παύλα· το `- item` είναι μια καταχώριση ακολουθίας.
• Ειδικοί χαρακτήρες χωρίς εισαγωγικά στην αρχή μιας τιμής — τα `@`, `` ` ``, `%`, `*`, `&` χρειάζονται εισαγωγικά.
• Μη υποστηριζόμενα χαρακτηριστικά στον μετατροπέα: άγκυρες (`&name`), ψευδώνυμα (`*name`) και ροές πολλαπλών εγγράφων (`---`) — για αυτά, χρησιμοποιήστε μια πλήρη βιβλιοθήκη YAML όπως js-yaml, PyYAML ή `yq`.

Το μήνυμα σφάλματος δείχνει τη γραμμή και τη στήλη όπου απέτυχε η ανάλυση.

Τρία χαρακτηριστικά YAML δεν έχουν άμεσο ισοδύναμο στο JSON και απαιτούν ειδικό χειρισμό:

• Άγκυρες (`&name`) και ψευδώνυμα (`*name`) επιτρέπουν στο YAML να αναφέρεται σε έναν κόμβο και να τον επαναχρησιμοποιεί αλλού — συνηθισμένα σε αρχεία Compose για κοινόχρηστα πρότυπα υπηρεσιών και στο CloudFormation για κοινόχρηστες παραμέτρους. Το JSON δεν διαθέτει σύνταξη αναφοράς, οπότε ο μετατροπέας αναπτύσσει τα ψευδώνυμα εντός γραμμής (inline) (κάθε ψευδώνυμο γίνεται πλήρες αντίγραφο). Τα δεδομένα διατηρούνται αλλά το JSON είναι μεγαλύτερο και η δομή κοινόχρηστης αναφοράς χάνεται.
• Ροές πολλαπλών εγγράφων (διαχωριστής `---`) αντιπροσωπεύουν πολλαπλές τιμές ανώτατου επιπέδου σε ένα αρχείο — συνηθισμένες για τη δέσμευση πόρων Kubernetes. Το JSON διαθέτει μόνο μεμονωμένες τιμές ρίζας ανά έγγραφο. Χωρίστε το YAML σε ξεχωριστά αρχεία πρώτα ή τυλίξτε τα έγγραφα σε έναν πίνακα JSON `[doc1, doc2, doc3]`.
• Σχόλια (`#`) υπάρχουν μόνο στο YAML — αφαιρούνται εντελώς κατά τη μετατροπή. Διατηρήστε το YAML ως πηγή αλήθειας εάν τα σχόλια έχουν σημασία.

Πέντε παράγοντες αμφίδρομης μετατροπής που πρέπει να γνωρίζει κάθε προγραμματιστής:

• Μοντέλο δεδομένων: YAML → JSON → YAML διατηρεί τα κλειδιά, τις τιμές, τους τύπους και τη ένθετη δομή ακριβώς. Τα δεδομένα είναι ίδια στην είσοδο και στην έξοδο.
• Σχόλια: χάνονται για πάντα — το JSON δεν έχει σύνταξη σχολίων. Διατηρήστε το YAML ως πηγή αλήθειας εάν έχετε ενσωματωμένα έγγραφα (inline docs).
• Άγκυρες/ψευδώνυμα: αναπτύσσονται στην πορεία προς το JSON, δεν δημιουργούνται ποτέ ξανά στην επιστροφή. Το YAML εξόδου έχει διπλότυπο περιεχόμενο όπου η πηγή είχε κοινόχρηστες αναφορές.
• Σειρά κλειδιών: το YAML διατηρεί τη σειρά προέλευσης· ο μετατροπέας τη διατηρεί έως το JSON· η επιστροφή στο YAML διατηρεί την ίδια σειρά.
• Ετικέτες τύπου (`!!str`, `!!int`) — εκπέμπονται μόνο όταν χρειάζονται για αποσαφήνιση. Μια συμβολοσειρά `"01234"` επιβιώνει στην αμφίδρομη μετατροπή επειδή το JSON τη διατηρεί σε εισαγωγικά· ένα YAML `01234` χωρίς εισαγωγικά αναλύεται ως ακέραιος αριθμός και επιστρέφει ως ο αριθμός 1234, χάνοντας το αρχικό μηδενικό.

Βάλτε αμφίβολες τιμές σε εισαγωγικά για προληπτικούς λόγους.

Αντιστοίχιση τύπων με μια ματιά:

• Χάρτης YAML → Αντικείμενο JSON
• Ακολουθία YAML → Πίνακας JSON
• Κλιμακωτή τιμή YAML (σύμφωνα με την εξαγωγή τύπου) → Συμβολοσειρά/αριθμός/boolean/null JSON
• Ετικέτα YAML !!str → Συμβολοσειρά JSON (εξαναγκασμένη)
• YAML null/~/κενό → JSON null
• YAML true/false → JSON boolean
• Μοτίβο ακέραιου YAML → Ακέραιος JSON
• Μοτίβο κινητής υποδιαστολής YAML → Αριθμός JSON

Σύγκριση εργαλείων:

• αυτός ο μετατροπέας (πρόγραμμα περιήγησης, άμεσος, χωρίς εγκατάσταση, 95% πραγματικού YAML)
• `yq -o json` (CLI, μεγάλα αρχεία, ερωτήματα JSONPath)
• `js-yaml`/`PyYAML` (πλήρης βιβλιοθήκη, υποστηρίζονται άγκυρες και πολλαπλά έγγραφα, προγραμματιστική χρήση)

Βέλτιστες πρακτικές:

• Να βάζετε πάντα σε εισαγωγικά τις αμφίβολες τιμές (yes/no/on/off/null/αριθμητικά αναγνωριστικά) στην πηγή YAML.
• Χρησιμοποιήστε εσοχή 2 διαστημάτων (το de facto πρότυπο).
• Επικυρώστε την έξοδο JSON έναντι του σχήματος του καταναλωτή σας (JSON Schema, OpenAPI, K8s OpenAPI) — τα σφάλματα τύπου εμφανίζονται εδώ.
• Διατηρήστε το YAML ως κανονική πηγή και αναδημιουργήστε το JSON κατά τον χρόνο δόμησης όποτε είναι δυνατόν.