YAML naar JSON omzetter

Wat is JSON?

// Convert YAML to JSON in Node.js using the eemeli/yaml library
import { parseAllDocuments } from 'yaml';

const yamlString = `apiVersion: apps/v1
kind: Deployment`;

// parseAllDocuments handles multi-document YAML (--- separator)
// version: '1.2' ensures yes/no are strings, not booleans
// merge: true expands anchor/alias merge keys (<<: *anchor)
const docs = parseAllDocuments(yamlString, { version: '1.2', merge: true });

// Take the first document (skip additional --- blocks)
const json = JSON.stringify(docs[0].toJSON(), null, 2);

console.log(json);
// {
//   "apiVersion": "apps/v1",
//   "kind": "Deployment"
// }

Kernfuncties

Voorbeelden

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  namespace: production
  labels:
    app: my-app
    version: 1.0.0
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app
          image: my-app:1.0.0
          ports:
            - containerPort: 8080
          resources:
            requests:
              memory: 64Mi
              cpu: 250m
            limits:
              memory: 128Mi
              cpu: 500m

version: '3.9'
services:
  web:
    image: nginx:1.25-alpine
    ports:
      - '80:80'
      - '443:443'
    environment:
      NGINX_HOST: example.com
      NGINX_PORT: '80'
    depends_on:
      - db
    restart: unless-stopped
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: secret
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata: {}

name: CI
on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: pnpm
      - name: Install dependencies
        run: pnpm install --frozen-lockfile
      - name: Run tests
        run: pnpm test

openapi: 3.0.3
info:
  title: User API
  version: 1.0.0
  description: Manage application users
paths:
  /users:
    get:
      summary: List users
      operationId: listUsers
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
  /users/{id}:
    get:
      summary: Get user
      operationId: getUser
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
          format: email

replicaCount: 3
image:
  repository: my-app
  tag: 1.0.0
  pullPolicy: IfNotPresent
service:
  type: ClusterIP
  port: 80
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: my-app.example.com
      paths:
        - path: /
          pathType: Prefix
resources:
  requests:
    memory: 64Mi
    cpu: 250m
  limits:
    memory: 128Mi
    cpu: 500m
autoscaling:
  enabled: false
  minReplicas: 1
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

- name: Configure web servers
  hosts: webservers
  become: true
  vars:
    http_port: 80
    max_clients: 200
  tasks:
    - name: Ensure nginx is installed
      ansible.builtin.package:
        name: nginx
        state: present
    - name: Start nginx service
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true
    - name: Copy nginx config
      ansible.builtin.template:
        src: nginx.conf.j2
        dest: /etc/nginx/nginx.conf
        owner: root
        group: root
        mode: '0644'
      notify:
        - Restart nginx
  handlers:
    - name: Restart nginx
      ansible.builtin.service:
        name: nginx
        state: restarted

Zo gebruik je het

1. 1

   Plak je YAML

   Voer je YAML-data in of plak deze in het invoerveld hierboven. Je kunt ook op 'Voorbeeld laden' klikken om een voorbeeld te proberen, zoals een Kubernetes Deployment, Docker Compose-bestand of Helm values.yaml.

2. 2

   Bekijk de live JSON-uitvoer

   JSON verschijnt direct in het uitvoerpaneel. Pas Opties aan (inspringing 2 of 4 spaties) om te voldoen aan de vereisten van je doeltool.

3. 3

   Kopieer of download

   Klik op Kopiëren om de JSON naar je klembord te halen, of op Downloaden om het op te slaan als .json-bestand dat klaar is voor jq, API-aanroepen of andere tooling.

Veelgemaakte YAML-fouten

services:
	web:
		image: nginx:1.25-alpine

services:
  web:
    image: nginx:1.25-alpine

metadata:
  name: my-app
   namespace: production

metadata:
  name: my-app
  namespace: production

url: http://example.com:8080/api
tag: #latest

url: 'http://example.com:8080/api'
tag: '#latest'

# Circular anchor (rare but possible)
base: &base
  parent: *base

# Use explicit fields instead of circular references
base:
  parent: null

# Only the first document is converted
apiVersion: v1
kind: ConfigMap
---
apiVersion: v1
kind: Secret

# Convert each document separately
apiVersion: v1
kind: ConfigMap

# This comment will be lost
replicas: 3 # scale this up for production

replicas: 3
_comment: scale this up for production

Veelvoorkomende gebruiksscenario's

Kubernetes-manifestanalyse

Zet Kubernetes YAML-manifests om naar JSON voor querying met jq, verzenden naar de Kubernetes REST API, verwerking in Terraform-gegevensbronnen of invoer in CI/CD-pipelines die JSON verwachten.

Docker Compose naar JavaScript-tooling

Lees Docker Compose YAML als JSON om servicedefinities, afbeeldingsnamen, poortmappings en omgevingsvariabelen te extraheren voor gebruik in automatiseringsscripts, afhankelijkheidsgraphs of Node.js-tooling.

GitHub Actions API-integratie

Zet GitHub Actions-workflow YAML om naar JSON om de structuur programmatisch te valideren, taak- en stepdefinities te extraheren of te integreren met CI/CD-API's die JSON-workflowspecificaties accepteren.

OpenAPI naar clientcodegeneratie

Veel codegeneratoren (openapi-generator, swagger-codegen, oazapfts) accepteren OpenAPI-specificaties in beide formaten. Zet je YAML-specificatie om naar JSON wanneer een tool specifiek JSON-invoer vereist of wanneer je het moet inspecteren met JSON Schema-validators.

Helm values-analyse

Zet Helm chart values.yaml om naar JSON om rapporten te genereren, waarden tussen omgevingen te vergelijken, in te voeren in beleidshandhavingstools of te verwerken met automatisering die JSON-configuratie verwacht.

Configuratiemigratie naar op JSON gebaseerde tools

Migreer applicatieconfiguratie van YAML (gebruikelijk in infrastructuurtools) naar JSON voor gebruik in JavaScript-omgevingen, REST API's, AWS AppConfig, Azure App Configuration of elk systeem dat configuratie als JSON opslaat.

Technische details

YAML 1.2-specificatie via parseAllDocuments met merge:true

YAML wordt verwerkt via de eemeli/yaml-bibliotheek (v2.8+, CVE-veilig) via parseAllDocuments met { version: '1.2', merge: true }. Het YAML 1.2-schema zorgt ervoor dat kale strings zoals yes en no als strings worden behandeld (niet als booleans), overeenkomend met de huidige YAML-specificatie. De optie merge: true breidt samenvoegsleutels voor ankers/aliassen (<<: *anker) volledig uit zodat de JSON-uitvoer volledige, dereferenced data bevat. YAML met meerdere documenten (--- gescheiden) retourneert het eerste document.

Uitbreiding van ankers en aliassen via bibliotheek

De eemeli/yaml-bibliotheek verwerkt de uitbreiding van ankers (&name) en aliassen (*name) veilig, inclusief detectie van circulaire verwijzingen. Alle gerefereerde datablokken — inclusief uitbreidingen van samenvoegsleutels — worden volledig ingelijnd in de JSON-uitvoer. Dit is de juiste transformatie omdat JSON geen referentie- of ankerconcept heeft. De veilige uitbreiding van de bibliotheek voorkomt oneindige lussen bij foutieve YAML.

Browsergebaseerd — geen upload, geen server

Alle verwerking vindt volledig plaats in de JavaScript-engine van je browser. Er worden geen gegevens via het netwerk verzonden. Invoer groter dan 200 KB schakelt automatisch over van live-modus naar handmatige modus (waarbij een expliciete klik op Omzetten nodig is) om de browser responsief te houden en blokkering van de hoofdthread tijdens zware serialisatie te voorkomen.

Aanbevolen aanpak

Gebruik YAML 1.2-compatibele syntaxis voor schone conversie

Schrijf je YAML met YAML 1.2-conventies — zet aanhalingstekens rond stringwaarden zoals yes, no, on, off, y en n (bijv. enabled: 'yes') om dubbelzinnigheid te vermijden. Deze tool verwerkt met het YAML 1.2-schema (dus dit zijn strings), maar oudere tools in je pipeline kunnen YAML 1.1 gebruiken (waarbij ze booleans worden). Expliciete aanhalingstekens in de bron-YAML is de veiligste aanpak voor alle parsers.

Zet aanhalingstekens rond grote getallen in YAML om precisie te bewaren

JavaScript kan gehele getallen groter dan 2^53 - 1 (9007199254740991) niet exact weergeven. Kubernetes-velden zoals resourceVersion en uid zijn int64 op de server en kunnen deze limiet overschrijden. Zet in je YAML-bron aanhalingstekens rond deze waarden (resourceVersion: '9007199254740993') zodat de parser ze als strings behandelt, die vervolgens exact als stringwaarden in de JSON-uitvoer worden bewaard.

Valideer JSON-uitvoer voordat je het in API's gebruikt

Na het omzetten van YAML naar JSON, valideer het resultaat voordat je het naar een API stuurt, opslaat of programmatisch verwerkt. Gebruik onze JSON-formatter om te bevestigen dat de structuur correct is. Dit is vooral belangrijk voor Kubernetes API-aanroepen, OpenAPI-specificaties en elke door JSON Schema gevalideerde payload, waarbij een structurele fout een verwarrende afwijzing op de API-laag veroorzaakt in plaats van bij de conversiestap.

Splits YAML met meerdere documenten voor het omzetten

Als je YAML-bestand meerdere --- gescheiden documenten bevat en je ze allemaal als JSON nodig hebt, splits dan het bestand eerst op --- en zet elk document afzonderlijk om. Deze tool neemt alleen het eerste document. Een eenvoudige aanpak: splits op '\n---\n' in je editor of met awk, en plak elk gedeelte dan afzonderlijk.

Gebruik jq voor verdere JSON-verwerking

Zodra je JSON hebt van je YAML, is jq de snelste manier om het te bevragen en te transformeren via de commandoregel. Combineer deze tool met jq: zet je YAML online om, plak de JSON, en gebruik dan jq '.spec.replicas' of jq '.services | keys' om precies te extraheren wat je nodig hebt. Voor batchverwerking van veel bestanden gebruik je de yq CLI met de -o json vlag direct.

Veelgestelde vragen