YAML-Abfragewerkzeug: Vollständiger Leitfaden
Führen Sie häufige yq-ähnliche Abfragen für YAML direkt im Browser aus, um Feldpfade, Array-Elemente und Konvertierungen in Konfigurationen, Manifests und Deployment-Ausschnitten ohne Upload zu prüfen.
Was dieses Tool macht
Es parst YAML und führt typische Pfadausdrücke wie .service.image, .items[0].name und Array-Wildcards aus.
Es unterstützt praktische Operationen wie keys, length, to_json und to_yaml für schnelle Wechsel zwischen YAML- und JSON-Ansichten.
Es zeigt Parsefehler und nicht unterstützte Syntax neben der Ausgabe an und macht klar, dass dies ein lokaler yq-Teilumfang und keine vollständige yq-Laufzeit ist.
Typische Anwendungsfälle
- Einen bestimmten verschachtelten Wert aus Kubernetes-, Docker-Compose- oder CI-Konfigurationen extrahieren.
- Vor Änderungen an YAML-Overlays prüfen, ob ein Pfadausdruck den erwarteten Knoten trifft.
- YAML-Ausschnitte nach JSON konvertieren, um sie in Debug-Requests, Dokumentation oder Test-Fixtures zu verwenden.
Eingabebeispiele
YAML-Konfiguration
service:
image: nginx:alpine
ports:
- 8080:80Abfrageausdruck
.service.image
Ausgabebeispiele
JSON-Ausgabe
{"image":"nginx:alpine","ports":["8080:80"]}Häufige Fehler und Lösungen
Es wird komplexe Syntax verwendet, die nur vollständiges yq unterstützt
Zerlegen Sie die Prüfung in unterstützte Operationen wie Pfadauswahl, Index, Wildcard, keys, length, to_json oder to_yaml.
YAML-Einrückung oder Listenformat ist ungültig
Korrigieren Sie Einrückung, Doppelpunkte und Array-Bindestriche und führen Sie die Abfrage erneut aus.
Der Abfragepfad trifft keinen Knoten
Prüfen Sie zuerst die oberste Struktur mit . oder keys und verfeinern Sie den Pfad schrittweise.
Hinweise zu Sicherheit und Datenschutz
- YAML-Parsing und Abfragen laufen vollständig im Browser.
- Entfernen Sie Schlüssel, Tokens und interne Hostnamen, bevor Sie Ausgaben in Tickets oder Chats kopieren.
- Bei Produktionskonfigurationen sollten Sie mit einem minimalen, maskierten Ausschnitt arbeiten.
Schritt-für-Schritt-Ablauf
- Fügen Sie einen minimalen YAML-Ausschnitt ein und prüfen Sie mit . zuerst die Gesamtstruktur.
- Geben Sie Feldpfade, Array-Indizes oder Wildcards schrittweise ein und vergleichen Sie das Ergebnis.
- Kopieren Sie Ausgaben erst nach dem Maskieren sensibler Werte.
Qualitätscheck vor dem Teilen
- Bestätigen Sie, dass der Ausdruck nur den unterstützten Teilumfang nutzt.
- Vergleichen Sie Ausgabe und Zielhierarchie, damit Einrückungsfehler keinen falschen Knoten treffen.
- Prüfen Sie vor dem Teilen auf Tokens, Passwörter, interne Domains und Kundendaten.
Praxishinweise
Geeignet für lokale Vorabprüfungen und Fehlersuche; produktive Automatisierung sollte weiterhin mit der im Team standardisierten yq-Version getestet werden.
Häufig gestellte Fragen
Ist das ein vollständiges yq?
Nein. Es deckt häufige lokale Abfragen und Formatwechsel ab; komplexe Filter sollten weiterhin mit dem offiziellen yq geprüft werden.
Werden YAML-Dokumente mit mehreren Teilen unterstützt?
Gängige YAML-Inhalte werden geparst. Komplexe Mehrdokument-Flows sollten in relevante Ausschnitte aufgeteilt werden.
Werden Daten hochgeladen?
Nein. Abfrage und Konvertierung bleiben in der aktuellen Browser-Sitzung.
