Konverter YAML ke JSON

Apa Itu 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"
// }

Fitur Utama

Contoh

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

Cara Menggunakan

1. 1

   Tempel YAML Anda

   Masukkan atau tempel data YAML ke kolom input di atas. Anda juga dapat klik 'Muat contoh' untuk mencoba sampel seperti Kubernetes Deployment, file Docker Compose, atau Helm values.yaml.

2. 2

   Lihat Output JSON Langsung

   JSON muncul seketika di panel output. Sesuaikan Options (indentasi 2 atau 4 spasi) agar sesuai dengan kebutuhan alat target Anda.

3. 3

   Salin atau Unduh

   Klik Copy untuk mengambil JSON ke clipboard, atau Download untuk menyimpannya sebagai file .json yang siap untuk jq, panggilan API, atau tooling hilir lainnya.

Kesalahan YAML Umum

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

Kasus Penggunaan Umum

Analisis Manifest Kubernetes

Konversi manifest YAML Kubernetes ke JSON untuk query dengan jq, pengiriman ke Kubernetes REST API, pemrosesan dalam sumber data Terraform, atau dimasukkan ke pipeline CI/CD yang mengharapkan JSON.

Docker Compose ke Tooling JavaScript

Parsing Docker Compose YAML ke JSON untuk mengekstrak definisi layanan, nama image, pemetaan port, dan variabel environment untuk digunakan dalam skrip otomasi, grafik dependensi, atau tooling Node.js.

Integrasi API GitHub Actions

Konversi workflow YAML GitHub Actions ke JSON untuk validasi struktur secara terprogram, ekstraksi definisi job dan step, atau integrasi dengan API CI/CD yang menerima spesifikasi workflow JSON.

OpenAPI ke Pembuatan Kode Klien

Banyak generator kode (openapi-generator, swagger-codegen, oazapfts) menerima spesifikasi OpenAPI dalam format apa pun. Konversi spesifikasi YAML Anda ke JSON ketika alat secara khusus memerlukan input JSON atau ketika Anda perlu memeriksanya dengan validator JSON Schema.

Analisis Nilai Helm

Konversi values.yaml chart Helm ke JSON untuk menghasilkan laporan, membandingkan nilai di berbagai lingkungan, dimasukkan ke alat penegakan kebijakan, atau diproses dengan otomasi yang mengharapkan konfigurasi JSON.

Migrasi Konfigurasi ke Alat Berbasis JSON

Migrasikan konfigurasi aplikasi dari YAML (umum dalam alat infrastruktur) ke JSON untuk digunakan di lingkungan JavaScript, REST API, AWS AppConfig, Azure App Configuration, atau sistem mana pun yang menyimpan konfigurasi sebagai JSON.

Detail Teknis

Spesifikasi YAML 1.2 via parseAllDocuments dengan merge:true

YAML diparsing menggunakan library eemeli/yaml (v2.8+, aman dari CVE) via parseAllDocuments dengan { version: '1.2', merge: true }. Skema YAML 1.2 memastikan string biasa seperti yes dan no diperlakukan sebagai string (bukan boolean), sesuai dengan spesifikasi YAML saat ini. Opsi merge: true sepenuhnya memperluas merge key anchor/alias (<<: *anchor) sehingga output JSON berisi data lengkap yang telah di-dereference. YAML multi-dokumen (dipisahkan oleh ---) mengembalikan dokumen pertama.

Ekspansi Anchor dan Alias via Library

Library eemeli/yaml menangani ekspansi anchor (&name) dan alias (*name) dengan aman, termasuk deteksi referensi melingkar. Semua blok data yang di-alias — termasuk ekspansi merge key — sepenuhnya di-inline di output JSON. Ini adalah transformasi yang benar karena JSON tidak memiliki konsep referensi atau anchor. Ekspansi aman dari library mencegah loop tak terbatas dari YAML yang tidak valid.

Berbasis Browser — Tanpa Upload, Tanpa Server

Semua pemrosesan terjadi sepenuhnya di JavaScript engine browser Anda. Tidak ada data yang ditransmisikan melalui jaringan kapan pun. Input yang lebih besar dari 200KB secara otomatis beralih dari mode langsung ke mode manual (memerlukan klik Convert eksplisit) untuk menjaga browser tetap responsif dan mencegah pemblokiran thread utama selama serialisasi berat.

Praktik Terbaik

Gunakan Sintaks yang Kompatibel dengan YAML 1.2 untuk Konversi yang Bersih

Tulis YAML Anda menggunakan konvensi YAML 1.2 — kutip nilai string yes, no, on, off, y, dan n secara eksplisit (misalnya, enabled: 'yes') untuk menghindari ambiguitas. Alat ini mem-parsing dengan skema YAML 1.2 (sehingga ini adalah string), tetapi alat lama dalam pipeline Anda mungkin menggunakan YAML 1.1 (di mana mereka menjadi boolean). Pengutipan eksplisit dalam sumber YAML adalah praktik paling aman di semua parser.

Kutip Angka Besar dalam YAML untuk Menjaga Presisi

JavaScript tidak dapat merepresentasikan bilangan bulat yang lebih besar dari 2^53 - 1 (9007199254740991) secara tepat. Field Kubernetes seperti resourceVersion dan uid adalah int64 di server dan dapat melebihi batas ini. Dalam sumber YAML Anda, kutip nilai-nilai ini (resourceVersion: '9007199254740993') sehingga parser memperlakukannya sebagai string, yang kemudian dipertahankan secara tepat di output JSON sebagai nilai string.

Validasi Output JSON Sebelum Digunakan di API

Setelah mengonversi YAML ke JSON, validasikan hasilnya sebelum mengirimkannya ke API, menyimpannya, atau memprosesnya secara terprogram. Gunakan JSON Formatter kami untuk mengkonfirmasi struktur sudah benar. Ini sangat penting untuk panggilan Kubernetes API, spesifikasi OpenAPI, dan payload yang divalidasi JSON Schema mana pun, di mana error struktural menyebabkan penolakan yang membingungkan di lapisan API daripada di langkah konversi.

Pisahkan YAML Multi-Dokumen Sebelum Mengonversi

Jika file YAML Anda berisi beberapa dokumen yang dipisahkan oleh --- dan Anda membutuhkan semuanya sebagai JSON, pisahkan file pada --- terlebih dahulu dan konversi setiap dokumen secara individual. Alat ini hanya mengambil dokumen pertama. Pendekatan sederhana: pisahkan pada '\n---\n' di editor Anda atau dengan awk, kemudian tempel setiap bagian secara terpisah.

Gunakan jq untuk Pemrosesan JSON Hilir

Setelah Anda mendapatkan JSON dari YAML, jq adalah cara tercepat untuk query dan mentransformasikannya dari command line. Gabungkan alat ini dengan jq: konversi YAML Anda secara online, tempel JSON, kemudian gunakan jq '.spec.replicas' atau jq '.services | keys' untuk mengekstrak persis apa yang Anda butuhkan. Untuk pemrosesan batch banyak file, gunakan yq CLI dengan flag -o json secara langsung.

Pertanyaan yang Sering Diajukan