Ücretsiz Çevrimiçi YAML Biçimlendirici – Kubernetes, Docker & CI için YAML'ı Güzelleştirin

Loading…

Bu YAML Biçimlendirici Hakkında Çevrimiçi YAML Biçimlendirici & Güzelleştirici

Dağınık `values.yaml`, `docker-compose.yml` veya GitHub Actions iş akışlarıyla mı uğraşıyorsunuz? Bu YAML biçimlendirici, çapa, takma adlar ve blok skalerleri korurken girintileme ve satır kaydırmayı normalleştirir. YAML'ınızı yapıştırın, girinti ayarlarını ayarlayın ve saniyeler içinde temiz, incelemeye hazır yapılandırmayı kopyalayın. 🚀

Bu YAML Biçimlendiricinin Temel Özellikleri

YAML 1.2 yapılandırma dosyaları için ayarlanmış Prettier tabanlı biçimlendirme
Yapılandırılabilir girinti boyutu (1–8) ve boşluklar vs sekmeler ile tutarlı girintileme
Uzun anahtarlar ve değerler okunabilir kalacak şekilde ayarlanabilir sarma / satır uzunluğu
Çapalar, takma adlar, dize olarak boole değerleri ve çok satırlı blok skalerleri doğru şekilde işler
Kubernetes, Docker Compose, CI işlem hatları ve daha fazlası için `.yaml` ve `.yml` dosyalarıyla çalışır
Düzenleyicinizden YAML'ı yapıştırın veya yapılandırma dosyalarını biçimlendiriciye sürükleyip bırakın
Biçimlendirilmiş YAML'ı düzenleyicinize veya deponuza tek tıkla kopyalayın
Biçimlendirme öncelikle tarayıcınızda istemci tarafında çalışır; güvenli bir sunucu yedeği yalnızca gerekli bir ayrıştırıcı/eklenti eksikse kullanılabilir

🔧 YAML Yapılandırma Dosyaları Nasıl Biçimlendirilir for yaml-formatter

1. YAML'ınızı Yapıştırın veya Yükleyin

Herhangi bir YAML parçasını (Kubernetes manifestosu, `docker-compose.yml`, GitHub Actions iş akışı, Ansible playbook'u vb.) kopyalayın ve düzenleyiciye yapıştırın veya bir `.yaml` / `.yml` dosyasını sürükleyip bırakın.

2. Girinti ve Sarmayı Ayarlayın

Boşluk mu yoksa sekmeler mi kullanılacağını seçin, girinti boyutunu (1–8 boşluk) ayarlayın ve takımınızın stilini eşleştirmek için sarma / satır uzunluğunu ayarlayın. `0` sarma uzunluğu, çok büyük bir dahili `printWidth` kullanarak sarmayı etkin bir şekilde devre dışı bırakır.

3. Biçimlendiriciyi Çalıştırın

**Biçimlendir** düğmesine tıklayın. Prettier tabanlı YAML motoru, anlamlar değişmeyecek şekilde çapalar, takma adlar ve blok skalerleri korurken yapılandırmanızı tutarlı girintiyle yeniden yazar.

4. Temiz YAML'ı Kopyalayın

Çıktıyı gözden geçirin, ardından biçimlendirilmiş YAML'ı düzenleyicinize geri kopyalayın, Git'e işleyin veya CI/CD'nize veya bulut sağlayıcı arayüzünüze yapıştırın.

Teknik Özellikler

Biçimlendirme Motoru & YAML Desteği

Bu araç, kullanıcı arayüzünde yüzeylenen yapılandırma seçenekleriyle Prettier tabanlı bir YAML biçimlendiricinin üzerine inşa edilmiştir.

Özellik	Destek	Notlar
YAML sürümü	✅ YAML 1.2 (tipik)	Kubernetes, Docker, CI/CD ve uygulamalarda kullanılan modern yapılandırma tarzı YAML için uygundur.
Çapalar ve takma adlar	✅ Korunur	Çevreleyen yapıyı yeniden girintilerken `&çapa` ve `*takmaad` referanslarını bozulmadan tutar.
Blok skalerleri	✅ Korunur	İç girintisi korunarak `\|` ve `>` blok skalerlerini muhafaza eder.
Booleanlar ve sayılar	✅ Dikkatli işleme	Biçimlendirme değerleri korur ancak `evet` ile "evet" veya `0012` ile "0012" arasındaki farkları ortaya çıkarabilir.
Çok belgeli YAML (`---`)	✅ Tipik	Aynı dosyadaki birden fazla belge sırayla tutulur ve tutarlı şekilde biçimlendirilir.

Belirli bir YAML parçası, paketlenmiş Prettier YAML ayrıştırıcısının anlamadığı son derece egzotik sözdizimi veya özel etiketler kullanıyorsa, bir ayrıştırıcı hatası görebilirsiniz. Bu durumda, parçayı basitleştirin veya kendi araç zincirinizle yerel olarak biçimlendirme çalıştırın.

Girinti, Satır Uzunluğu ve Çıktı Stili

Biçimlendirici, projenizin stilini mümkün olduğunca yakından eşleştirebilmeniz için temel seçenekleri sunar.

Ayar	Seçenekler	Pratik Öneri
Girinti stili	Boşluklar / Sekmeler	Çoğu YAML stil rehberi boşlukları önerir; yalnızca ekibiniz açıkça tercih ediyorsa sekmeler kullanın.
Girinti boyutu	1–8 boşluk	Kubernetes ve Docker için 2 boşluk yaygındır; ekstra görsel netlik için 4 boşluk kullanılır.
Sarma / satır uzunluğu	0–120 sütun	`0` sarmayı devre dışı bırakır (çok büyük bir dahili `printWidth` kullanır), 80–100 farkları kompakt tutar.
Dosya uzantıları	.yaml, .yml	Araç yapılandırmasındaki `fileExtensions` ve `acceptedFileTypes` ile eşleşir.

Çevrimiçi biçimlendirmenin yerel geliştirme ve CI kontrolleriyle eşleşmesi için bu seçenekleri deponuzdaki `.prettierrc` veya `.editorconfig` ile hizalayın.

Sınırlar ve Performans

Bir tarayıcı sekmesinde YAML yapılandırmalarının etkileşimli biçimlendirilmesi için optimize edilmiştir.

Parametre	Sınır / Davranış	Notlar
Maksimum metin giriş boyutu	≈ 2 MB (~2.000.000 karakter)	Biçimlendirici işlevi içinde uygulanan güvenlik sınırı.
Maksimum dosya yükleme boyutu	≈ 5 MB	Kolaylık ve güvenilirlik için UI `maxFileSize` ayarıyla sınırlıdır.
Biçimlendirme zaman aşımı	~25 saniye	Tarayıcının takılmasını önlemek için uzun süren işlemler iptal edilir.
Birincil yürütme	İstemci tarafı	`runPrettier` ve bir Prettier YAML eklentisi aracılığıyla doğrudan tarayıcınızda çalışır.
Sunucu yedeklemesi	Yalnızca ayrıştırıcı/eklenti hatalarında	Gerekli bir ayrıştırıcı eklentisi eksikse, güvenli bir `/api/yaml-formatter` uç noktası yedek olarak kullanılabilir.

Büyük YAML paketleri (Helm chart'ları, dev CRD kütüphaneleri vb.) için, `prettier` veya `yq` gibi CLI'ları yerel iş akışınıza veya CI pipeline'larınıza entegre etmeyi tercih edin.

YAML Biçimlendirme için CLI Alternatifleri

Hızlı temizlikler için çevrimiçi biçimlendiriciyi kullanın, büyük projeler ve otomatik pipeline'lar için CLI araçlarına güvenin.

Linux / 🍏 macOS

yq ile bir YAML dosyasını biçimlendir (güzel yazdır)

yq eval -P config.yaml > config.formatted.yaml

YAML'ı tutarlı girinti ve anahtar sıralamasıyla yeniden yazar (yq sürümüne bağlı olarak).

Prettier ile YAML'ı normalleştir

prettier --parser yaml --write "**/*.{yaml,yml}"

Tüm deponuzda aynı motor sınıfını (Prettier YAML ayrıştırıcı) çalıştırır.

Windows (PowerShell / cmd)

PowerShell + yq kullanarak YAML'ı biçimlendir

yq eval -P config.yaml | Set-Content config.formatted.yaml

YAML'ı güzel yazdırır ve sonucu diske yazar.

PowerShell nesneleri aracılığıyla YAML'ı gidiş-dönüş işle

Get-Content config.yaml -Raw | ConvertFrom-Yaml | ConvertTo-Yaml | Set-Content config.formatted.yaml

Yapıyı ve girintiyi normalleştirmek için PowerShell'ın YAML desteğini kullanır.

Bu çevrimiçi biçimlendiriciyi, CI pipeline'ınızda bir `prettier --check` veya `yq` adımıyla birleştirerek depodaki tüm YAML'ın tutarlı biçimlendirilmiş kalmasını garanti edin.

Pratik YAML Kullanım Senaryoları

Altyapı & Kubernetes Bildirimleri

Kod incelemesinden önce Kubernetes `Deployment`, `Service` ve `Ingress` bildirimlerini biçimlendirin.
Helm chart'larındaki `values.yaml` dosyalarını farkları daha temiz hale getirmek için normalleştirin.
CRD'ler, ConfigMap'ler ve Secret'ların YAML'ını ortamlar arasında tutarlı girintili tutun.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: my-app
          image: my-app:latest
          ports:
            - containerPort: 80

Docker Compose & Yerel Geliştirme Yapılandırması

Belgelerde veya taleplerde paylaşmadan önce `docker-compose.yml`'i güzelleştirin.
Hizmetlerin, ağların ve birimlerin girintilerini hizalayarak bakımı kolaylaştırın.
Blog yazıları ve oryantasyon rehberleri için temiz YAML parçacıkları hazırlayın.

version: "3.9"
services:
  web:
    image: myapp:latest
    ports:
      - "8080:80"
    environment:
      - NODE_ENV=production
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example

CI/CD Boru Hatları ve Otomasyon

GitHub Actions iş akışlarını biçimlendirin (`.github/workflows/*.yml`).
GitLab CI (`.gitlab-ci.yml`) veya Azure Pipelines YAML'ını temizleyin.
Otomasyon ve altyapı-kod-olarak YAML'larını ekipler arasında okunabilir tutun.

name: CI
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm ci
      - run: npm test

❓ Frequently Asked Questions

❓Bu YAML biçimlendirici ne yapar?

YAML girdisini (genellikle yapılandırma dosyalarını) alır ve Prettier tabanlı bir YAML motoru kullanarak tutarlı girinti ve sarmalama ile yeniden yazar. Yapılandırmanızın anlamı aynı kalır, ancak düzeni okumak ve incelemek çok daha kolay hale gelir.

🧩Hangi YAML özellikleri destekleniyor?

Biçimlendirici, yapılandırma dosyalarında kullanılan yaygın YAML 1.2 özellikleri için tasarlanmıştır: eşlemeler, listeler, çapa ve takma adlar, blok skalerler (`|` / `>`), ve `---` ile ayrılmış çoklu belge dosyaları. Özel etiketler ve çok egzotik yapılar, temel alınan ayrıştırıcı tarafından tam olarak desteklenmeyebilir.

📏YAML girdisi için bir boyut sınırı var mı?

Kararlılık ve tarayıcı performansı için, metin girişi yaklaşık 2 MB (~2.000.000 karakter) ve yüklenen dosyalar yaklaşık 5 MB ile sınırlıdır. Daha büyük kod tabanları veya oluşturulmuş YAML için, bunun yerine CLI'nızdan veya CI boru hattınızdan Prettier veya yq çalıştırın.

🔐YAML'ım bir sunucuya yükleniyor mu?

Biçimlendirme, `runPrettier` ve Prettier YAML eklentisi aracılığıyla öncelikle tarayıcınızda çalışır, bu nedenle YAML'ınız normal işlem sırasında istemciden ayrılmaz. Gerekli bir ayrıştırıcı eklentisinin eksik olduğu nadir durumlarda, araç güvenli bir `/api/yaml-formatter` uç noktasına geri dönebilir. O zaman bile, YAML'ınız yalnızca geçici olarak işlenir ve saklanmaz.

⚠️Neden bazen ayrıştırıcı hataları görüyorum?

Ayrıştırıcı hataları genellikle YAML'ın hatalı biçimlendirildiği (örneğin, tutarsız girinti, eksik `:` veya hizalanmamış liste öğeleri) veya paketlenmiş ayrıştırıcının anlamadığı sözdizimi kullandığı anlamına gelir. Girintiyi ve yapıyı doğrulayın veya parçacığı basitleştirmeyi deneyin, ardından biçimlendiriciyi tekrar çalıştırın.

📚Bu, yerel Prettier kurulumumla nasıl ilişkili?

Bu araç, `prettier --parser yaml` çalıştırmaya benzer şekilde, arka planda Prettier tabanlı bir YAML motoru kullanır. Hızlı tek seferlik düzeltmeler için kullanabilir ve tam proje biçimlendirme için yerel `.prettierrc` ve CLI komutlarınıza güvenmeye devam edebilirsiniz.

Pro Tips

Best Practice

Bir depodaki tüm YAML'ları (Kubernetes, GitHub Actions, Docker Compose) aynı girinti stiliyle normalleştirerek farkları ve incelemeleri çok daha kolay hale getirin.

Best Practice

`yes`, `no`, `on`, `off`, `0012` gibi değerlere dikkat edin – bunları boolean veya sekizli benzeri sayılar yerine string olarak işlenmesini istiyorsanız tırnak içine alın.

Best Practice

Belgeler veya biletler için hızlıca snippet'leri temizlemek üzere bu çevrimiçi biçimlendiriciyi kullanın, ardından tam projeler için ön-işleme kancalarında `prettier` veya `yq`'ya güvenin.

CI Tip

Büyük yapılandırmaları yeniden düzenlerken, önce biçimlendirin ki anlamsal değişiklikler Git farklarında girinti gürültüsüne gömülmek yerine net bir şekilde öne çıksın.