YAML Nedir?

YAML, özellikle ayar dosyaları için tercih edilen sade bir veri biçimidir. Parantez ve tırnak kalabalığı yerine girinti kullanır, bu yüzden göze daha temiz görünür.

YAML nedir?

Adı, "YAML Ain't Markup Language" ifadesinin kısaltması olarak açıklanır. Bir YAML belgesinde hiyerarşi, satır başındaki boşluk sayısıyla belirlenir. Anahtar ile değer iki nokta ile ayrılır, liste elemanları ise tire ile başlar.

Varsayımsal bir uygulama ayarı:

uygulama:
  ad: siparis-servisi
  port: 8080
  ozellikler:
    - bildirim
    - raporlama

Aynı bilgiyi JSON ile yazsaydınız süslü parantezler, köşeli parantezler ve tırnaklar gerekirdi. YAML 1.2 sürümü JSON'u kapsayacak biçimde tasarlandığı için geçerli bir JSON belgesi çoğu durumda geçerli bir YAML belgesidir.

Nerelerde kullanılır?

Yazılım altyapısında YAML her yerdedir. Docker Compose dosyaları, Kubernetes tanımları, GitHub Actions iş akışları ve birçok uygulamanın ayar dosyası bu biçimdedir. No-code ve otomasyon araçlarının bazıları da akış tanımlarını YAML olarak dışa aktarır.

Sık yapılan hatalar

En büyük tuzak girintidir. YAML'da sekme (tab) karakteri kullanılmaz, yalnızca boşluk kullanılır. Tek bir boşluk kayması bir ayarı yanlış başlığın altına taşıyabilir ve hata mesajı her zaman sorunun yerini net göstermez.

İkinci tuzak, değerlerin beklenmedik biçimde yorumlanmasıdır. Eski YAML sürümlerini izleyen bazı okuyucular, tırnaksız yazılan "no", "yes" ya da "on" gibi kelimeleri metin yerine doğru/yanlış değeri olarak okuyabilir. Ülke kodu "NO" gibi değerleri tırnak içine almak bu sorunu önler. Dosyayı kaydetmeden önce bir YAML doğrulayıcıdan geçirmek hataların çoğunu yakalar.