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

YAML nedir ve neden JSON'dan dönüştürülür?

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

const data = JSON.parse('{"apiVersion":"apps/v1","kind":"Deployment"}');

// version: '1.1' ensures Norway-problem strings (yes/no/on/off/y/n)
// are automatically quoted in the output for YAML 1.1 parser safety
const doc = new Document(data, { version: '1.1' });

const yamlString = doc.toString({
  indent: 2,
  lineWidth: 0,         // disable line wrapping
  defaultStringType: 'PLAIN',   // Auto mode: only quote when needed
});

console.log(yamlString);
// 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"}}}}}}

{"name":"my-app","version":"1.0.0","description":"A sample Node.js application","private":true,"scripts":{"dev":"vite","build":"tsc && vite build","preview":"vite preview","test":"vitest","lint":"eslint . --ext .ts,.tsx"},"dependencies":{"react":"^18.3.0","react-dom":"^18.3.0"},"devDependencies":{"typescript":"^5.4.0","vite":"^5.2.0","vitest":"^1.5.0","eslint":"^8.57.0","@types/react":"^18.3.0"},"engines":{"node":">=20.0.0","pnpm":">=9.0.0"}}

{"format_version":"1.0","terraform_version":"1.7.4","variables":{"region":{"value":"us-east-1"}},"planned_values":{"root_module":{"resources":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","values":{"bucket":"my-app-assets","force_destroy":false,"tags":{"Environment":"production","ManagedBy":"terraform"}}}]}},"resource_changes":[{"address":"aws_s3_bucket.main","mode":"managed","type":"aws_s3_bucket","name":"main","change":{"actions":["create"],"before":null,"after":{"bucket":"my-app-assets","force_destroy":false}}}]}

Nasıl Kullanılır

1. 1

   JSON Verilerinizi Yapıştırın

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

2. 2

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

   YAML, çıktı panelinde anında görünür. Hedef aracınızın gereksinimlerini karşılamak için Seçenekleri (girinti 2/4, tırnak Otomatik/Çift/Tek, stil Blok/Akış) ayarlayın.

3. 3

   Kopyalayın veya İndirin

   YAML'ı panoya almak için Kopyala'ya veya kubectl apply, docker compose up ya da başka araçlar için hazır olan .yaml dosyası olarak kaydetmek için İndir'e tıklayın.

Yaygın Dönüştürme Tuzakları

{"name": "Alice", "role": "admin",}

{"name": "Alice", "role": "admin"}

{'name': 'Alice', 'active': true}

{"name": "Alice", "active": true}

{name: "Alice", role: "admin"}

{"name": "Alice", "role": "admin"}

{"port": 8080 // HTTP port}

{"port": 8080}

# JSON input: {"country": "no", "enabled": "yes"}
# YAML without quoting (dangerous):
country: no
enabled: yes
# YAML 1.1 parser reads: country=false, enabled=true

# YAML with Auto quoting (safe):
country: 'no'
enabled: 'yes'
# YAML 1.1 parser reads: country="no", enabled="yes"

// JSON input (resourceVersion is int64 on K8s server)
{"resourceVersion": 9007199254740993}
// JavaScript reads it as: 9007199254740992 (precision lost)
// YAML output will contain the wrong number

// Store large integers as strings to preserve precision
{"resourceVersion": "9007199254740993"}
// YAML output: resourceVersion: '9007199254740993' (exact)

Yaygın Kullanım Senaryoları

Kubernetes Manifest'leri

kubectl get -o json veya Kubernetes API'sinden gelen JSON API yanıtlarını GitOps iş akışları, Kustomize overlay'leri ve kubectl apply -f dağıtımları için YAML manifest'lerine dönüştürün.

Docker Compose Dosyaları

docker inspect JSON çıktısını veya programlı olarak oluşturulan servis yapılandırmalarını docker compose up ve Docker Stack dağıtımlarıyla uyumlu docker-compose.yaml dosyalarına dönüştürün.

Helm Chart Değerleri

JSON yapılandırma dışa aktarmalarını Helm chart dağıtımları için YAML değerleri dosyalarına dönüştürün; temiz YAML sözdizimi ile sürüm kontrollü altyapı yapılandırması sağlayın.

GitHub Actions İş Akışları

GitHub Actions iş akışı tanımlarını JSON'da programlı olarak oluşturun ve GitHub Actions çalıştırıcısının gerektirdiği .github/workflows/*.yaml formatına dönüştürün.

OpenAPI Spesifikasyonları

Pek çok framework'ün (FastAPI, SpringDoc) JSON formatında döndürdüğü OpenAPI/Swagger spesifikasyonlarını Swagger UI, Redoc ve API ağ geçidi araçlarının tercih ettiği YAML formatına dönüştürün.

Yapılandırma Geçişi

JSON'da saklanan uygulama yapılandırmalarını (appsettings.json, config.json) YAML gerektiren veya tercih eden araçlar için YAML formatına geçirin; yorum kullanarak belgeleme imkânı ekleyin.

Teknik Ayrıntılar

RFC 8259 Uyumlu JSON Ayrıştırma

JSON girişi, tam RFC 8259 uyumlu tarayıcının yerel JSON.parse() işlevi kullanılarak ayrıştırılır. Bu, konum bilgisi (satır ve sütun numaraları) dahil doğru sözdizimi hata mesajları sağlar ve tüm JSON veri türlerini işler: dizeler, sayılar, boolean değerler, null, diziler ve nesneler.

YAML 1.1 Şemasıyla eemeli/yaml Document API üzerinden YAML 1.2 Çıktısı

YAML, version: '1.1' ile eemeli/yaml kütüphanesi (v2.8+, CVE güvenli) Document API'si üzerinden üretilir. Bu kombinasyon, YAML 1.2 uyumlu çıktı üretirken YAML 1.1 tırnak kurallarını uygular — yani Norway sorunlu dizeler (yes/no/on/off/y/n) çıktıda otomatik olarak tırnak içine alınır ve hem YAML 1.1 hem de 1.2 ayrıştırıcıları için güvenli olur. Satır kaydırma devre dışı bırakılır (lineWidth: 0) ve uzun dizeler bütünüyle korunur.

%100 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

DevOps Yapılandırmaları için Her Zaman Otomatik Tırnak Modu Kullanın

JSON'u Kubernetes, Helm, Ansible, Docker Compose veya GitHub Actions için dönüştürürken her zaman varsayılan Otomatik (Norway güvenli) tırnak modunu kullanın. Bu araçlardaki YAML 1.1 ayrıştırıcıları, çıplak yes, no, on, off, y ve n dizelerini sessizce boolean olarak yanlış okur — Otomatik mod bunu şeffaf biçimde önler.

Bulut-Native Araçlar için 2 Boşluk Girinti Kullanın

Kubernetes, Docker Compose, GitHub Actions ve Helm standardı olarak 2 boşluk girinti kullanır. Bu dosyalarda 4 boşluk girinti geçerli YAML olmakla birlikte topluluk örnekleriyle, otomatik oluşturulan yapılandırmalarla ve ekibinizin mevcut manifest'leriyle tutarsızlık yaratır.

Dönüştürmeden Önce Büyük Tam Sayıları Dize Olarak Saklayın

Kubernetes'in resourceVersion, uid ve API sunucusundaki diğer int64 alanları JavaScript'in güvenli tam sayı aralığını (2^53 - 1) aşabilir. Tam sayı hassasiyetine ihtiyacınız varsa, bu değerleri dönüştürmeden önce JSON dizesi olarak saklayın. Bu, sunucu tarafında oluşturulan alanlar içeren kubectl get -o json çıktısı için özellikle önemlidir.

Önce JSON'u Doğrulayın

JSON kaynağınız elle yazılmış veya zaman zaman geçersiz çıktı üreten bir sistemden (sondaki virgüller, tırnaksız anahtarlar, yorumlar) geliyorsa, dönüştürmeden önce bir JSON biçimlendirici ile doğrulayın. Önce sözdizimi hatalarını yakalamak ve düzeltmek için JSON Biçimlendirici aracımızı kullanın, ardından temiz JSON'u YAML'a dönüştürün.

Sürüm Kontrolüne Gidecek Dosyalar için Blok Stili Tercih Edin

Blok stili YAML, her alan kendi satırında göründüğünden Git'te temiz, insan tarafından okunabilir diff'ler üretir. Akış stili (kompakt, satır içi) diff'leri okumayı ve incelemeyi zorlaştırır. Akış stilini belgelere kısa YAML parçacıkları eklemek veya kompakt çıktı gerektiren araçlar için saklayın.

Sıkça Sorulan Sorular