YAML'dan JSON'a Dönüştürücü

JSON nedir?

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

Temel Özellikler

Örnekler

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

Nasıl Kullanılır

1. 1

   YAML Verilerinizi Yapıştırın

   YAML verilerinizi yukarıdaki giriş alanına girin veya yapıştırın. Kubernetes Deployment, Docker Compose dosyası veya Helm values.yaml gibi bir örnek denemek için «Örnek yükle» düğmesine de tıklayabilirsiniz.

2. 2

   Canlı JSON Çıktısını Görün

   JSON, çıktı panelinde anında görünür. Hedef aracınızın gereksinimlerini karşılamak için Seçenekleri (girinti 2 veya 4 boşluk) ayarlayın.

3. 3

   Kopyalayın veya İndirin

   JSON'u panoya almak için Kopyala'ya veya jq, API çağrıları ya da herhangi bir aşağı akış aracı için hazır olan .json dosyası olarak kaydetmek için İndir'e tıklayın.

Yaygın YAML Tuzakları

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

Yaygın Kullanım Senaryoları

Kubernetes Manifest Analizi

Kubernetes YAML manifest'lerini jq ile sorgulamak, Kubernetes REST API'sine göndermek, Terraform veri kaynaklarında işlemek veya JSON bekleyen CI/CD pipeline'larına beslemek için JSON'a dönüştürün.

Docker Compose'dan JavaScript Araçlarına

Docker Compose YAML'ını otomasyon betiklerinde, bağımlılık grafiklerinde veya Node.js araçlarında kullanmak için servis tanımlarını, imaj adlarını, port eşlemelerini ve ortam değişkenlerini JSON'a çıkarmak üzere ayrıştırın.

GitHub Actions API Entegrasyonu

GitHub Actions iş akışı YAML'ını yapıyı programlı olarak doğrulamak, iş ve adım tanımlarını çıkarmak veya JSON iş akışı spesifikasyonu kabul eden CI/CD API'leriyle entegre etmek için JSON'a dönüştürün.

OpenAPI'den İstemci Kod Üretimine

Pek çok kod üreteci (openapi-generator, swagger-codegen, oazapfts) her iki formattaki OpenAPI spesifikasyonlarını kabul eder. Bir araç özellikle JSON girişi gerektirdiğinde veya JSON Schema doğrulayıcılarıyla incelemeniz gerektiğinde YAML spesifikasyonunuzu JSON'a dönüştürün.

Helm Değerleri Analizi

Helm chart values.yaml dosyasını raporlar oluşturmak, ortamlar arasında değerleri karşılaştırmak, politika uygulama araçlarına beslemek veya JSON yapılandırması bekleyen otomasyon araçlarıyla işlemek için JSON'a dönüştürün.

JSON Tabanlı Araçlara Yapılandırma Geçişi

Uygulama yapılandırmasını YAML'dan (altyapı araçlarında yaygın) JavaScript ortamları, REST API'leri, AWS AppConfig, Azure App Configuration veya yapılandırmayı JSON olarak saklayan herhangi bir sistem için JSON'a geçirin.

Teknik Ayrıntılar

merge:true ile parseAllDocuments Üzerinden YAML 1.2 Spesifikasyonu

YAML, { version: '1.2', merge: true } seçenekleriyle parseAllDocuments kullanılarak eemeli/yaml kütüphanesi (v2.8+, CVE güvenli) üzerinden ayrıştırılır. YAML 1.2 şeması, yes ve no gibi çıplak dizelerin güncel YAML spesifikasyonuyla uyumlu biçimde dize (boolean değil) olarak değerlendirilmesini sağlar. merge: true seçeneği, çapa/takma ad birleştirme anahtarlarını (<<: *anchor) tamamen genişleterek JSON çıktısının eksiksiz, referanssız veri içermesini sağlar. Çok belgeli YAML (--- ile ayrılmış) ilk belgeyi döndürür.

Kütüphane Üzerinden Çapa ve Takma Ad Genişlemesi

eemeli/yaml kütüphanesi, döngüsel referans tespiti dahil çapa (&name) ve takma ad (*name) genişlemesini güvenle işler. Birleştirme anahtarı genişlemeleri dahil tüm takma ad atanan veri blokları JSON çıktısında tamamen satır içine alınır. Bu her zaman doğru dönüşümdür çünkü JSON'da referans veya çapa kavramı yoktur. Kütüphanenin güvenli genişlemesi, hatalı biçimlendirilmiş YAML'dan kaynaklanabilecek sonsuz döngüleri önler.

Tarayıcı Tabanlı — Yükleme Yok, Sunucu Yok

Tüm işlem tamamen tarayıcınızın JavaScript motorunda gerçekleşir. Hiçbir veri hiçbir noktada ağ üzerinden iletilmez. 200KB'ı aşan girişler, tarayıcının yanıt vermeye devam etmesi ve yoğun serileştirme sırasında ana iş parçacığının bloke olmasını önlemek için otomatik olarak canlı moddan manuel moda (açık bir Dönüştür tıklaması gerektirir) geçer.

En İyi Uygulamalar

Temiz Dönüştürme için YAML 1.2 Uyumlu Sözdizimi Kullanın

YAML'ınızı YAML 1.2 standartlarıyla yazın — belirsizliği önlemek için yes, no, on, off, y ve n dize değerlerini açıkça tırnak içine alın (örn. enabled: 'yes'). Bu araç YAML 1.2 şemasıyla ayrıştırır (bunlar dizedir); ancak pipeline'ınızdaki eski araçlar YAML 1.1 kullanıyor olabilir (bunları boolean olarak okur). Kaynak YAML'da açıkça tırnak kullanmak, tüm ayrıştırıcılar için en güvenli uygulamadır.

Hassasiyeti Korumak için YAML'da Büyük Sayıları Tırnak İçine Alın

JavaScript, 2^53 - 1'den büyük (9007199254740991) tam sayıları hassas biçimde temsil edemez. Kubernetes'in resourceVersion ve uid alanları gibi sunucu tarafında int64 olan alanlar bu sınırı aşabilir. YAML kaynağınızda bu değerleri tırnak içine alın (resourceVersion: '9007199254740993'); böylece ayrıştırıcı bunları dize olarak değerlendirir ve JSON çıktısında dize değerleri olarak hassas biçimde korunur.

Kullanmadan Önce JSON Çıktısını Doğrulayın

YAML'ı JSON'a dönüştürdükten sonra bir API'ye göndermeden, saklamadan veya programlı olarak işlemeden önce sonucu doğrulayın. Yapının doğru olduğunu teyit etmek için JSON Biçimlendirici'yi kullanın. Bu, yapısal bir hatanın dönüştürme adımında değil, API katmanında kafa karıştırıcı bir reddedişe neden olduğu Kubernetes API çağrıları, OpenAPI spesifikasyonları ve JSON Schema doğrulamalı yükler için özellikle önemlidir.

Dönüştürmeden Önce Çok Belgeli YAML'ı Ayırın

YAML dosyanız birden fazla --- ile ayrılmış belge içeriyorsa ve hepsini JSON olarak almanız gerekiyorsa, önce dosyayı --- üzerinden bölün ve her belgeyi ayrı ayrı dönüştürün. Bu araç yalnızca ilk belgeyi alır. Basit bir yaklaşım: düzenleyicinizde '\n---\n' üzerinden bölün ya da awk kullanın ve her bölümü ayrı ayrı yapıştırın.

Aşağı Akış JSON İşleme için jq Kullanın

YAML'dan JSON aldıktan sonra, jq komut satırından onu sorgulamanın ve dönüştürmenin en hızlı yoludur. Bu aracı jq ile birleştirin: YAML'ı online dönüştürün, JSON'u yapıştırın, ardından tam olarak ihtiyacınız olanı çıkarmak için jq '.spec.replicas' veya jq '.services | keys' kullanın. Toplu dosya işleme için -o json bayrağıyla doğrudan yq CLI'yi kullanın.

Sıkça Sorulan Sorular