RadarGitHub Radarai üretimi

GitHub Radar — etcd

Raft fikir birliği, bbolt tabanlı MVCC depolama ve ReadIndex optimizasyonuyla dağıtık sistem durumunu yöneten açık kaynaklı anahtar-değer veritabanı.

etcd, modern dağıtık sistemlerde ve Kubernetes kümelerinde küme durumunu, servis keşfini ve yapılandırma verilerini mutlak bir tutarlılıkla (strong consistency) saklamak amacıyla CoreOS tarafından başlatılıp Cloud Native Computing Foundation (CNCF) bünyesinde saf Go ile geliştirilen açık kaynaklı, dağıtık bir anahtar-değer veritabanıdır 1. Geleneksel veritabanlarının ağ bölünmelerinde (network partition) veri tutarsızlığına düştüğü veya lider seçimlerinde kilitlendiği kırılgan mimarilere karşı etcd; Raft fikir birliği algoritması, bellek içi B-tree ile diskteki bbolt B+tree motorunu birleştiren çok sürümlü eşzamanlılık denetimi (MVCC) ve gRPC tabanlı Watch akışlarıyla modern bulut altyapısının vazgeçilmez omurgasını oluşturan devrimci bir sistem aracıdır 2.

Dağıtık sistemler, bulut yerel mimari ve Kubernetes çevrelerinde 47 bin yıldız ve son commit bugün düzeyinde sarsılmaz bir küresel güven inşa eden depo, titizlikle yönetilen 139 açık issue ve kararlı yamaları içeren son sürüm v3.6.16 (Ekim 2026) metrikleriyle olgunluğunu kanıtlamaktadır.

Mimari Deep-Dive: etcd

etcd’nin sistem mimarisinde yarattığı en büyük mühendislik sıçraması, dağıtık fikir birliğini salt bir kütük kopyalama mekanizması olarak bırakmayıp katı bir mantıksal zaman saati (revision) etrafında şekillenen durum bilgisi motoruyla bütünleştirmesidir. Proje bütünüyle saf Go diliyle geliştirilmiştir 1. Go seçimi; platformlar arası bağımsız tek bir statik ikili dosya derleyebilmek, Kubernetes ekosistemiyle sıfır CGO sürtünmesiyle konuşabilmek ve goroutine tabanlı eşzamanlılıkla binlerce eşzamanlı gRPC HTTP/2 akışını alt milisaniyelik gecikmelerle yönetebilmek amacıyla yapılmıştır.

Sistemin kalbinde yer alan ilk temel mimari sütun çok sürümlü eşzamanlılık denetimi (MVCC) ve iki katmanlı dizin yapısıdır 2. etcd, verileri yerinde güncellemez (in-place update yapmaz). Yapılan her yazma veya silme işlemi, küme genelinde monotonik olarak artan 64 bitlik küresel bir sürüm numarası (revision) üretir. Bellekte çalışan B-tree dizini (keyIndex), kullanıcı anahtarlarını doğrudan değerlerine değil, bu anahtarın geçmişteki tüm revizyonlarına eşler. Diskteki kalıcı depolama ise mmap destekli gömülü bir B+tree olan bbolt motoruna emanettir. bbolt üzerindeki anahtarlar doğrudan revizyon numaralarıdır; değerler ise serileştirilmiş kullanıcı verileridir. Bu ayrım sayesinde okuma işlemleri yazma kilitlerine takılmaz; bir istemci geçmişteki belirli bir revizyona ait anlık görüntüyü (snapshot) sıfır kilit çekişmesiyle okuyabilir.

İkinci kritik sütun gRPC tabanlı Watch akışı ve iki aşamalı dinleyici yönetimidir 2. İstemciler tek bir HTTP/2 TCP bağlantısı üzerinden yüzlerce farklı anahtar aralığını dinleyebilir. etcd, dinleyicileri en güncel revizyonu yakalamış olanlar (synced) ve geçmiş revizyonları geriden takip edenler (unsynced) olarak ikiye ayırır. Güncel olaylar doğrudan bellek tamponundan istemciye aktarılırken, geçmiş olaylar bbolt üzerinden okunarak sisteme aşırı yük binmesi engellenir.

Üçüncü sütun ise disk G/Ç maliyetini sıfırlayan ReadIndex optimizasyonudur 3. Klasik Raft protokolünde doğrusal tutarlı (linearizable) bir okuma yapabilmek için liderin Raft kütüğüne yeni bir girdi yazıp diske fsync yapması gerekirdi. etcd, ReadIndex mekanizmasıyla liderin çoğunluk (quorum) ile hafif kalp atışları üzerinden konuşarak liderliğini teyit etmesini sağlar; teyit alındığında istek doğrudan yerel MVCC deposundan disk yazması yapılmadan sunulur. Bu mimari karar, Kubernetes API sunucusunun saniyede on binlerce okuma isteğini disk darboğazına uğramadan karşılamasını mümkün kılar.

Kod ve Topluluk Sağlığı

etcd, CNCF bünyesinde mezun (graduated) statüsünde yer alan ve Google, Red Hat, IBM, AWS ve VMware gibi dev bulut altyapı sağlayıcılarının kıdemli sistem programcılarından oluşan yetkin bir çekirdek komite tarafından yönetilmektedir 1. Gezegendeki neredeyse tüm Kubernetes kümelerinin durum motorunu oluşturan proje, yazılım mühendisliği tarihindeki en yoğun test edilmiş ve doğrulanmış dağıtık sistem uygulamalarından biridir.

Depodaki 139 açık issue sayısı, milyarlarca dolarlık bulut altyapısını taşıyan bir veritabanı için olağanüstü derecede düşük ve sıkı yönetilen bir hata envanterine işaret eder. Bakımcı kadrosu Jepsen testleri, otomatik arıza enjeksiyonları (fault injection) ve veri bozulması tespit mekanizmalarıyla (--experimental-initial-corrupt-check) kod kalitesini en üst düzeyde tutmaktadır 4. Çekirdek depoya sunulan her çekme isteği (PR); zorlu ağ bölünmesi simülasyonlarından, bellek sızıntısı tarayıcılarından ve katı Go yarışma denetleyicisi (race detector) testlerinden geçer. Sürümleme takvimi kurumsal semantik kurallara titizlikle uymaktadır. health_score bu bölümden türer: issue kapanma hızı, sürüm düzeni, bakımcı ekibi. Ajanın tahminidir; künyede öyle yazılır. Projenin dağıtık sistemler dünyasındaki temel taşı rolü, kusursuz mühendislik kalitesi ve endüstri standardı güvenilirliği dikkate alınarak health_score: 9.5 takdir edilmiştir.

Production Riski: Gerçekten Kullanılır mı?

etcd’yi kurumsal altyapılarına dahil etmeyi değerlendiren sistem mimarları için lisanslama açısından hiçbir hukuki risk bulunmamaktadır; proje Apache 2.0 lisansı ile dağıtılmakta olup şirket içi veri merkezlerinde, özel bulutlarda veya ticari Kubernetes dağıtımlarında tam kullanım serbestisi sunar 5.

etcd’nin üretimde tartışmasız hayat kurtardığı senaryolar son derece açıktır: Dağıtık servisler arasında kilit (distributed lock) yönetimi yapmak, lider seçimi yürütmek, mikroservislerin dinamik konfigürasyonlarını anlık olarak dinleyip güncellemek ve Kubernetes benzeri küme yönetim platformları inşa etmek. Saf Go ile yazılmış bağımsız ikilisi ve etcdctl aracıyla operasyonel kurulum sürtünmesi düşüktür.

Buna karşın, operasyonel olarak yönetilmesi gereken katı sınırlar vardır. İlk ve en ölümcül risk disk G/Ç gecikmesidir; Raft kütük yazımları sıralı fsync gerektirdiğinden, yavaş ağ depolama birimlerinde (yüksek gecikmeli NFS veya yavaş EBS) disk gecikmesi 10 milisaniyeyi aştığında lider seçim fırtınaları (election storms) başlar ve küme kilitlenir; bu nedenle yerel NVMe SSD kullanımı şarttır. İkinci kısıt ise MVCC sıkıştırma (compaction) ve parçalanma (defragmentation) yönetimidir; revizyonlar düzenli temizlenmediğinde bbolt veritabanı 8 gigabaytlık kota sınırına ulaşıp yazmaları durdurur (alarm: NOSPACE). Canlı defrag işlemi küme düğümlerine geçici kilit koyduğundan otomasyonlar dikkatle kurgulanmalıdır. Bu parametreler doğru ayarlandığında etcd, dağıtık veri tutarlılığı için geliştirilmiş dünyanın en sağlam açık kaynak motorudur.

Kaynaklar

  1. etcd GitHub Ana Kod Deposu
  2. etcd Resmi API ve MVCC Mimarisi Dokümantasyonu
  3. etcd Kalıcı Depolama ve WAL Dosya Mimarisi
  4. etcd 3.6 Sürüm Değişiklik Günlüğü ve Sürüm Notları
  5. etcd Apache 2.0 Açık Kaynak Lisans Dosyası