Vercel Project Connections, ekiplerin SDK anahtarı olmadan feature flag'lerini projeler arasında paylaşmasını sağlıyor

Vercel ne duyurdu

Vercel, Vercel Flags için bir özellik olan Project Connections'ı kullanıma sundu; bu özellik sayesinde bir uygulama, aynı ekipteki başka bir projede tanımlı feature flag'leri SDK anahtarları paylaşmadan değerlendirebiliyor. Vercel blog'una göre özellik tüm planlarda mevcut.

Ortadan kaldırdığı sorun, birden fazla servis çalıştıran ekiplere tanıdık gelecektir. Şimdiye kadar bir projenin başka bir projenin flag'lerine ihtiyacı varsa, birinin kaynak projenin server SDK anahtarını tüketen taraftaki bir environment değişkenine kopyalaması ve bu gizli anahtarı elle senkronize tutması gerekiyordu. Bu, gerekenden daha geniş kapsamlı bir kimlik bilgisi, döndürülmesi gereken bir sır ve anahtar sızdığında süregelen bir risk anlamına geliyordu.

Bağlantılar nasıl çalışıyor

Bağlantılar, her projenin Flags bölümündeki Connections sayfasından ya da Vercel CLI'daki vercel flags connections komutuyla yapılandırılıyor. Sayfa, ilişkinin her iki yönünü de gösteriyor: hangi projelerin mevcut projenin flag'lerini okumasına izin verildiği ve mevcut projenin hangi projeleri okuduğu. Tekil bağlantılar buradan eklenebilir veya kaldırılabilir.

Kimlik doğrulama, paylaşılan bir sır yerine deployment kimliğiyle yapılıyor. Bağlı projeler kim olduklarını kendi deployment'larının kimliğiyle kanıtlıyor; yerel geliştirme için ise vercel env pull çalıştırmak projenin OIDC token'ını alıyor ve böylece aynı akış canlı bir deployment dışında da çalışıyor.

Erişim modeli bilinçli olarak dar tutulmuş. Bağlantılar salt okunur ve tüm ortamları kapsıyor; hangi ortamın flag'lerinin geçerli olacağına tüketen deployment karar veriyor — bir production deployment, production flag'lerini değerlendiriyor. Bir bağlantıyı iptal etmek için her iki uygulamayı da yeniden deploy etmek gerekmiyor.

Geliştiricilerin ne yapması gerekiyor

Tüketen tarafta geliştirici, kaynak projenin ID'sini işaret eden bir flags adapter'ı oluşturuyor. Vercel blog'u bunu @flags-sdk/vercel paketindeki createVercelAdapter ile gösteriyor: adapter kaynak proje tanımlayıcısıyla başlatılıyor ve ardından her flag — örneğin new-checkout anahtarına sahip bir boolean — o adapter üzerinde bir anahtar ve varsayılan bir değerle tanımlanıyor. Bu şekilde bildirilen flag'ler bağlı kaynak projeye karşı değerlendiriliyor.

Dikkat edilmesi gereken sürüm gereksinimleri var. Duyuruya göre özellik, @flags-sdk/vercel 1.6.0 veya sonrasını; core kütüphanesini doğrudan kullanan ekipler içinse @vercel/flags-core 1.11.0 veya sonrasını gerektiriyor. Bağlantıları komut satırından yönetmek için Vercel CLI 63.0.0 veya daha yeni bir sürüm gerekiyor.

Neden önemli

Servisler arası feature flag'ler gerçek mimarilerde yaygındır — bir checkout servisi, bir pazarlama sitesi ve bir iç dashboard genellikle aynı toggle'lara tepki vermek zorundadır. Eski anahtarı-kopyala iş akışı, flag tanımlarını çoğaltmak ile sırları etrafa yaymak arasında bir ödünleşim dayatıyordu ve kopyalanan her SDK anahtarı, onu oluşturan değişiklikten daha uzun ömürlü bir kimlik bilgisiydi.

Yetkilendirmeyi deployment kimliğine bağlayarak Vercel paylaşılan sırrı tamamen ortadan kaldırıyor: sızacak, döndürülecek veya environment değişkenleri arasında denetlenecek bir şey kalmıyor. Salt okunur kapsam, bağlı bir tüketicinin neler yapabileceğini sınırlıyor ve erişimi yeniden deploy etmeden kesme imkânı, ekiplere bir bağlantının artık var olmaması gerektiğinde hızlı bir müdahale yolu sunuyor.

Zaten Flags ile birden fazla Vercel projesi çalıştıran ekipler için bu, elle yapılan ve hataya açık bir işi bildirimsel bir ayara dönüştürüyor. Ve her planda, kurumsal bir katmanda değil sunulduğu için küçük ekipler de büyük ekiplerle aynı projeler arası yeteneğe kavuşuyor.