GitHub ölçekte nasıl çalışıyor: spoke kümeleri, paylaşımlı fork deposu ve anahtarsız OIDC

dev.to'da, yazarın tamiz.pro blogunda özgün olarak yayımlanan teknik bir derinleme inceleme, GitHub'ın küresel bir kod platformu olarak çalışmasını sağlayan üç mekanizmayı inceliyor: bölgesel 'spoke' kümeleri, fork'ları düşük maliyetle saklamayı sağlayan git alternates mekanizması ve CI hatları için anahtarsız OIDC kimlik doğrulaması. Yazar Tamizuddin, GitHub'ın herkese açık dokümantasyonundan yola çıkıyor ve yazıyı GitHub'ın açıklamadığı iç ayrıntılar yerine kavramlar ve ödünleşimler çevresinde kurguluyor.

Spoke'lar her bölgeye eksiksiz bir sunum yüzeyi yerleştiriyor

Yazıya göre GitHub, platformunu hub-and-spoke topolojisiyle bölgesel birimlere bölüyor. Her spoke, kullanıcıya dönük yüzeyin neredeyse eksiksiz bir dağıtımı: REST ve GraphQL çağrılarını yanıtlayan bir API gateway'i, git push ve fetch işlemlerini yerel olarak sonlandıran servisler ve webhook olaylarını alan ve yayan altyapı. Geliştirici etkileşimlerinin çoğu okuma ağırlıklı olduğundan ve bölge içinde kaldığından, bunları yerel olarak yönlendirmek algılanan gecikmeyi düşük tutuyor.

Asıl zor sorun küresel tutarlılık. Yazı, Tokyo'daki bir geliştirici ile São Paulo'daki bir diğerinin ayrı spoke'lara konuşurken kısa süre farklı durum görebildiği, nihai tutarlılığa dayalı bir modeli anlatıyor. Çatışma yönetimi, yeni commit'lerin ve ref'lerin mevcut durumu ezmediği, içerik adresli ve büyük ölçüde yalnızca ekleme yapan git nesne modeliyle kolaylaşıyor; ancak depo ayarları, branch'ler, tag'ler ve pull request durumu gibi değiştirilebilir veriler açık çatışma algılaması gerektiriyor. Yoğunluk altında, yüksek trafiğe sahip işlemler kısıtlanıyor ya da kuyruğa alınıyor ve bir bölge diğerlerini boğamıyor; tutarlılık garantileri işlem başına seçiliyor: bir branch push'u küresel düzeyde güçlü olabilirken bir profil güncellemesinin eşzamansız olarak yakınsamasına izin veriliyor. Operasyonel tarafta spoke'lar kanarya sürümleriyle bağımsız olarak dağıtılıyor, bölgeler arası metrikler gecikmenin kaynağını izlemek için ilişkilendiriliyor ve bozulan bir spoke trafiğini başka bir bölgeye devrederken kullanıcı oturumları ile webhook olayları bu geçişi atlatıyor.

Fork'lar git alternates üzerinden nesne paylaşıyor

İkinci mekanizma depolama katmanında. Git, bir deponun .git/objects/info/alternates dosyası aracılığıyla başka bir nesne dizinine işaret etmesine izin veriyor; nesne aramaları önce yerel depoya bakıyor, ardından alternatif konuma düşüyor. Yazıya göre GitHub bir fork oluşturduğunda, commit ve tree geçmişinin paylaşılan büyük bölümü ebeveyn deponun nesne deposunda kalırken fork yalnızca kendine özgü nesneleri yazıyor. Milyonlarca fork'u olan popüler bir depo için, yazarın savunduğu gibi bu, tek bir paylaşılan taban artı küçük yerel deltalar ile her fork için tüm geçmişi çoğaltmak arasındaki fark. Ağ davranışı da kazanıyor, çünkü istemci ebeveyn deponun nesnelerine zaten sahipse packfile'lar küçülüyor.

Ödünleşimler ise koordinasyon sorunları. Çöp toplama, nesne paylaşan depolar arasında koordine edilmek zorunda ki bir fork bağımlı olduğu geçmişi asla kaybetmesin. Yoğun fork oluşturma ya da pack üretimi, diğer kiracıları aç bırakmaması için kuyruklar ve kaynak kotalarıyla yalıtılmalı. Yetkilendirme ise öyle uygulanmalı ki bir fork kullanıcısı görmesine izin verilen paylaşılan nesneleri okuyabilsin ama ebeveynden ya da kardeş fork'lardan veri sızmasın.

Anahtarsız OIDC statik CI gizli dizilerini emekli ediyor

Üçüncü ayak CI/CD ile ilgili. GitHub Actions workflow'ları rutin olarak bulut sağlayıcılarını, secrets manager'ları ve SaaS API'lerini çağırıyor; geleneksel yaklaşımda uzun ömürlü statik kimlik bilgileri secrets içinde saklanıyor. Yazı, OpenID Connect üzerine kurulu anahtarsız alternatifi anlatıyor: GitHub, workflow'un kimliğini ve izinlerini beyan eden kısa ömürlü imzalı bir JWT çıkarıyor, dış servis bunu herkese açık anahtarlarla doğruluyor ve token'ın kapsamları ile geçerlilik süresi neler yapabileceğini ve ne kadar süre yapabileceğini sınırlıyor. Dinlenme halinde bir kimlik bilgisi olmadığından, log'lara, imajlara ya da depolara sızıp yıllarca çalışmaya devam edebilecek bir şey yok — yazarın sıfır güven (zero-trust) ilkeleriyle bağlantı kurduğu bir yaklaşım.

Neden önemli

Yazı, hipers ölçekli çok kiracılı bir sistemin ardındaki örüntülere yönelik bir saha rehberi işlevi görüyor: tutarlılık garantilerini sistem geneli yerine işlem başına seçmek, depolamayı kopyayla değil referansla tekilleştirmek ve kalıcı kimlik bilgilerinin yerini kısa ömürlü, doğrulanabilir kimlikle değiştirmek. Her örüntü kod barındırmanın ötesinde, her küresel dağıtımlı SaaS'a, her çok kiracılı depolama katmanına ve hâlâ statik gizli dizilerle çalışan her hatta iyi genelleniyor. Ayrıca kullanıcıların doğal karşıladığı iki şeyi açıklıyor: uzun geçmişe sahip bir depoyu fork'lamanın neden anında ve ucuz hissettirdiğini ve CI güvenlik rehberliğinin neden saklanan anahtarlar yerine OIDC'de giderek birleştiğini.