Web yazılımda test ortamından canlıya geçiş, çalışan dosyaları başka bir sunucuya kopyalamaktan daha geniş bir süreçtir. Yayınlanan sürümün hangi kaynaklardan üretildiği, hangi veritabanı yapısını beklediği ve hangi dış hizmetlere bağlandığı bilinmelidir. Testte doğru görünen bir form, canlıda farklı bir yetkiyle veya eksik yapılandırmayla çalışabilir. Güvenli geçiş planı, bu farkları yayın anında keşfetmek yerine önceden görünür kılar ve karar sorumluluğunu belirler. Web yazılım tesliminde canlıya geçiş kararı, teknik değişiklikle birlikte işin hangi koşulda durdurulacağını bilen bir sorumluya bağlanmalıdır.
Web yazılımda kontrollü yayın süreci, geliştirme, içerik ve operasyon ekiplerinin aynı sürüm kaydını kullanmasını gerektirir. Bu rehber; ortam ayrımı, gizli değerlerin yönetimi, sürüm paketi, veritabanı uyumluluğu, gözlem ve geri alma kararlarını teknik bir akışta birleştirir. Anlatılan senaryo temsilîdir. Belirli bir altyapıda kesintisiz yayın, sıfır veri kaybı veya ölçülmüş müşteri sonucu vaat etmez; uygulanacak yöntem projenin mimarisiyle doğrulanmalıdır.
Ortamların adını değil, çalışma sınırlarını ayırın
Geliştirme ortamı günlük değişiklikleri, test ortamı yayın adayının kontrolünü, canlı ortam ise gerçek kullanıcı işlemlerini taşır. Bunların aynı alan adı altında farklı klasörlerde bulunması tek başına yeterli ayrım değildir. Veritabanı bağlantıları, depolama alanları, oturum ayarları, zamanlanmış görevler ve dış servis kimlikleri ayrı incelenmelidir. Bir test uygulamasının canlı başvuruları değiştirebilmesi veya gerçek ödeme isteği gönderebilmesi, ortam adlarının doğru olmasına rağmen operasyonel bir sorundur.
İhtiyaç analizi ve MVP kapsamı belgesindeki görevleri ortamlara eşleyin. Hangi görev test verisiyle denenebilir, hangisi dış sağlayıcının deneme hesabını gerektirir? Örneğin başvurunun kurum ekranına ulaşması test edilebilirken gerçek müşteriye bildirim gitmesi engellenmelidir. Ortam tablosuna uygulama adresi, veri kaynağı, bildirim hedefi, sorumlu ve erişim kapsamı ekleyin. Gizli değerlerin kendisini bu tabloya yazmayın; güvenli erişim yöntemini belirtin.
Test ortamında gerçek verinin kullanılmasını otomatik tercih haline getirmeyin. Senaryo için üretilen örnek kayıtlar çoğu işlev kontrolünü daha kontrollü yürütmeyi sağlar. Gerçek veriye ihtiyaç varsa kapsamı, erişimi ve saklama kararını yetkili kişiler değerlendirmelidir. Arama motorlarına indekslememe talimatı vermek, ortamı yetkisiz erişime kapatmaz. İndeksleme tercihi ile kimlerin erişebileceği ayrı kontrollerdir; biri diğerinin yapılmış olduğu anlamına gelmez.
Ortamların tamamen aynı olduğunu söylemek yerine bilinçli farklarını yazın. Örneğin deneme ödeme hesabı, düşük kapasiteli test sunucusu veya devre dışı bildirim kanalı normal olabilir. Bu farkların hangi test sonucunu sınırladığı belirtilmelidir. Testteki küçük veri kümesiyle hızlı çalışan bir işlem, canlıdaki veri hacminde ayrıca değerlendirme gerektirebilir. Eşdeğerlik kaydı, farklılığı saklamak için değil, bir ortamdan diğerine hangi sonucun taşınabileceğini açıklamak için kullanılır.
Gizli değerleri yayın paketinden ve kanıtlardan uzak tutun
Veritabanı parolası, servis anahtarı ve imzalama sırrı gibi değerler kaynak koddan bağımsız yönetilmelidir. OWASP gizli değer yönetimi rehberi, erişimin ihtiyaca göre sınırlandırılması ve sırların günlük kaydına düşürülmemesi gibi ilkeleri açıklar. Bir yapılandırma dosyasının farklı olması, erişim ayrımının doğru kurulduğunu kanıtlamaz. Canlı sırra hangi işlem veya kullanıcı erişebiliyor sorusu ayrıca yanıtlanmalıdır.
Yönetim paneli rolleri ile dağıtım yetkileri farklı sorumluluklardır. İçerik editörü yayın yapabilse de sunucu ayarlarını değiştirmek veya canlı servis anahtarını görmek zorunda değildir. Sürüm çıkaran hesabın yetkileri de gerekli işlemlerle sınırlanmalıdır. Ekran görüntüsü, hata raporu ve dağıtım günlüğü hazırlanırken gizli değerlerin görünmediğini kontrol edin. Kanıt toplama süreci, erişim bilgisini yeni dosyalara çoğaltmamalıdır.
Gizli değerin yenilenmesi, yalnız yeni metnin bir yere yazılması değildir. Hangi uygulamanın eski değeri kullanmaya devam ettiği, işlemin nasıl doğrulanacağı ve bir hata halinde kimin devreye gireceği planlanmalıdır. Bu rehber belirli bir sır saklama ürünü veya bütün sistemlerde aynı sonucu veren yöntem önermiyor. Projenin desteklediği güvenli mekanizma ve erişim yaşam döngüsü üzerinden ilerlemek, araç adından daha somut bir kabul koşulu oluşturur.
Yayın adayını tek sürüm kimliğiyle dondurun
Kontrol edilen paket ile canlıya çıkan paket aynı sürüm kaydına bağlanmalıdır. Kaynak kod kimliği, derleme çıktısı, bağımlılık kilitleri ve gerekli yapılandırma adları bu kayıtta bulunabilir. Test onayından sonra fark edilmeyen bir dosya değişikliği yapılırsa önceki onayın hangi sürüm için geçerli olduğu belirsizleşir. Bu nedenle değişiklik olduğunda etkilenen kontroller yeniden değerlendirilir; önceki yeşil durum bütün yeni pakete otomatik taşınmaz.
Proje devralma kontrolü bu noktada kaynak sahipliği ve teslim sorumluluğunu netleştirir. Temsilî bir sürüm kaydı; aday kimliği, değişen işlevler, bağımlılıklar, beklenen veri yapısı, test kanıtları ve önceki çalışır paketin konumunu içerebilir. Dosya özeti, aktarımda beklenmeyen değişikliği anlamaya yardımcı olur. Ancak aynı özet, uygulamanın doğru çalıştığını veya güvenlik bakımından eksiksiz incelendiğini tek başına göstermez.
Dinamik içerik ile uygulama paketini de ayırın. Paneldeki sayfalar, menüler veya form tanımları veritabanında tutuluyorsa yalnız tema dosyalarını kopyalamak tüm değişikliği taşımayabilir. Tersine, test veritabanını bütünüyle canlıya almak gerçek kullanıcı işlemlerini silebilir. Hangi yapılandırma veya içerik değişikliğinin taşınacağı ayrıca listelenmeli; uygulama dağıtımı, kurumun güncel verilerini ezmek için gerekçe haline gelmemelidir.
Yayın paketinin tarayıcıya ulaşan bölümünü de unutmayın. Yeni sayfa yapısıyla eski betik veya stilin birlikte sunulması, sunucuda doğru sürüm bulunmasına rağmen farklı bir davranış yaratabilir. Varlık sürümleri ve kullanılan önbellek düzeni incelenmeli; çözüm olarak bütün katmanların körlemesine temizlenmesi önerilmemelidir. Gerçek sayfada içerik, betik ve görselin beklenen sürümle uyumunu kontrol edin. Formlar ile kullanıcıya özel yanıtların önbellek koşulları ayrı değerlendirilmelidir.
Veritabanı değişikliğini kod dağıtımından ayrı tasarlayın
Yeni sürümün eklediği alan, değiştirdiği ilişki veya kaldırdığı sütun, eski kodla uyumluluğu etkileyebilir. Dağıtım sırasında eski ve yeni süreçler bir süre birlikte çalışacaksa bu aralık özellikle önemlidir. Bir işlemin yalnız yeni yapıyla çalışması, eski süreç devam ederken hata doğurabilir. İnceleme bu nedenle hem ileri geçişi hem de önceki uygulama sürümüne dönülürse veri yapısının nasıl davranacağını ele almalıdır.
GitLab veritabanı geçişleri dokümantasyonu, sütun kaldırma ve yeniden adlandırma gibi işlemleri aşamalı ele alan örnekler sunar. Bu kaynak GitLab'ın kendi teknoloji bağlamına aittir; komutları başka projeye doğrudan kopyalamak uygun değildir. Buradan alınabilecek genel ders, uygulama ile veri yapısı arasındaki uyumluluk penceresini açıkça tasarlamaktır. Kullanılan veritabanının kilitleme ve işlem davranışı kendi resmî belgeleriyle ayrıca doğrulanmalıdır.
Temsilî örnekte bir başvuru kaydına yeni bir sınıflandırma alanı eklendiğini düşünün. Önce mevcut kayıtları bozmayan yapı ve bu alan olmadan da çalışabilen uygulama davranışı hazırlanabilir. Veriler dönüştürülürken eksik veya beklenmeyen değerlerin nasıl ele alınacağı belirlenir. Eski kullanımın kaldırılması ise ayrı bir karar olabilir. Bu örnek, her mimaride aynı sıranın yeterli olduğunu değil, yıkıcı değişikliklerin tek adımda gizlenmemesi gerektiğini anlatır.
Entegrasyonlarda hata ve veri tutarlılığı açısından arka plan işleri ve bekleyen iletiler de hesaba katılmalıdır. Önceki sürümün ürettiği bir iş, yeni süreç tarafından okunacak mı? Yeni alanı içermeyen bir mesaj nasıl karşılanacak? Kuyrukları düşünmeden yalnız web sayfasını test etmek, sürüm uyumsuzluğunun başka bir işlemde ortaya çıkmasına yol açabilir. Bu soruların yanıtı sürümün ön koşulları arasında tutulmalıdır.
Uzun süren veri adımında bağlantı koparsa işlemin sonucunu bilmeden aynı adımı yeniden başlatmayın. Hangi bölümün tamamlandığını gösteren kayıt ve güvenli devam yöntemi önceden tasarlanmalıdır. Tekrar çalıştırmanın aynı sonucu verip vermeyeceği kullanılan dönüşüme bağlıdır; bütün geçişler kendiliğinden tekrar güvenli değildir. Yetkili ekip, tamamlanma durumunu doğruladıktan sonra devam veya düzeltme kararı vermelidir. Böylece görünmeyen yarım işlem, ikinci bir çalıştırmayla daha karmaşık hale getirilmez.
Geri alma kararını yayın öncesinde yazın
Geri alma planı, önceki dosyaları geri kopyalamaktan ibaret değildir. Yeni sürüm gerçek kayıt oluşturmuşsa uygulamayı geriye almak bu kayıtların nasıl okunacağını da etkiler. Veri dönüşümü tersine çevrilemiyorsa başka bir düzeltme yolu gerekebilir. Sorumlular; yayını durdurma, önceki uygulamaya dönme veya ileri yönde düzeltme kararlarının hangi koşullarda verileceğini önceden değerlendirmelidir. Bu seçeneklerin tamamı her sistemde kullanılabilir varsayılmamalıdır.
Yedekleme ve geri yükleme testi ayrı bir kurtarma kanıtıdır. Yedeğin bulunması, dağıtımı güvenle geri almanın aynı şey olduğu anlamına gelmez. Geri yükleme canlıda sonradan oluşan işlemleri kaybettirebileceği için veri noktası ve iş etkisi değerlendirilmelidir. Yayın kaydında hangi geri dönüşün denendiğini ve hangi seçeneklerin yalnız taslak durumda olduğunu açıkça gösterin; denenmemiş bir tarif tamamlanmış prova gibi sunulmamalıdır.
Ön kontrolleri değişikliğin etkisine göre seçin
Genel kontrol listesi başlangıç sağlar; her sürüm aynı riski taşımaz. Yalnız metin düzenleyen değişiklik ile başvuru yönlendirmesini değiştiren sürümün kontrol kapsamı farklı olabilir. Yayına alma kabul listesi üzerinden başlayıp değişen işlevlere ve bağımlılıklara özel senaryolar ekleyin. Bir kontrolün tamamlanması, yapılmayan başka bir kontrol için başarı kanıtı üretmez.
- Sürüm kapısı: onaylanan paket kimliği, değişiklik kapsamı ve test kanıtları aynı kayıtla eşleşiyor mu?
- Ortam kapısı: canlı bağlantılar, erişim sınırları ve dış hizmet hedefleri ilgili sorumlularca kontrol edildi mi?
- Veri kapısı: geçiş adımları, eski ve yeni sürüm uyumluluğu ile bekleyen işler için karar var mı?
- İşlev kapısı: değişen kullanıcı görevleri beklenen sonuçla ve uygun test verisiyle doğrulandı mı?
- Gözlem kapısı: hangi sinyalin yayını durduracağı, bunu kimin izleyeceği ve karar süresi belli mi?
- Geri dönüş kapısı: uygulanabilir seçenek, yetkili kişi ve veri üzerindeki olası etki kayda geçti mi?
Web tasarımda hız bütçesi yaklaşımını yeni betikler veya dış araçlar ekleyen sürümlere uygulayabilirsiniz. Tek bir başarılı yükleme bütün kullanıcı koşullarındaki performansı göstermez. Ölçüm ortamı, kullanılan örnek sayfalar ve önceki karşılaştırma noktası rapora eklenmelidir. Görünür içerik eksikken alınan bir hız sonucu da kabul için yeterli sayılmamalıdır; işlevin ve ölçümün birlikte anlamlı olması gerekir.
Geçiş yöntemini altyapının desteklediği sınırlar içinde seçin
Tek seferde değiştirme, ayrı sürüm alanları arasında geçiş veya sınırlı kullanıcı grubuyla başlama gibi yöntemler farklı gereksinimler taşır. Altyapı desteklemiyorsa yalnız yöntem adını kullanmak güvenli geçiş sağlamaz. Örneğin oturum paylaşımı, dosya yüklemeleri veya ortak veritabanı iki sürümün aynı anda çalışmasını sınırlayabilir. Yayın planı, yöntemin gerektirdiği bileşenleri ve hangi riskleri azaltamadığını açıklamalıdır.
Google SRE canary yayın rehberi, değişikliğin sınırlı bir bölümde ve belirli süre değerlendirilerek yayına devam kararının verilmesini ele alır. Bu değerlendirmede sinyallerin kullanıcıya yansıyan sorunları göstermesi önemlidir. Kurumsal bir projede kullanılacak yöntem, trafik yapısı ve altyapı olanaklarıyla birlikte seçilmelidir. Az trafik altında kısa süre hata görülmemesi, bütün kullanıcı yollarının sorunsuz olduğuna tek başına kanıt oluşturmaz.
Temsilî bir başvuru akışında geçişi prova edin
Örnek senaryoda, başvurunun seçilen hizmete göre farklı ekibe yönlendirileceği bir sürüm hazırlansın. Testte en az iki hizmet seçimi ve geçersiz seçim davranışı incelenir. Beklenen kayıt, ekip ataması ve bildirim hedefi ayrı sonuçlar olarak yazılır. Başarılı ekran mesajı görülmesi, ilgili ekibin başvuruyu gerçekten işleyebildiğini tek başına göstermez. Senaryo bu nedenle kayıt ekranında ve uygun test alıcısında da kontrol edilmelidir. Canlıya çıkan bir kurumsal web sitesi için prova kaydında başvurunun gönderildiği ekranı ve aynı kaydın panelde görüldüğü yeri birlikte belirtin.
Canlı geçişte aynı denemelerin gerçek kişilere veya yanlış ekiplere istenmeyen bildirim üretmemesi gerekir. Test kaydının ayırt edilebilir kimliği, yetkilendirme ve temizleme kararı önceden belirlenir. İşlem zamanları ile görülen sonuçlar sürüm kaydına eklenir. Hata halinde aynı başvuruyu tekrar göndermeden önce oluşmuş kayıt kontrol edilir. Böylece bir gecikmeyi başarısızlık sanıp mükerrer işlem üretme riski azaltılabilir; tekrar davranışı uygulamanın tasarımına göre doğrulanmalıdır.
Canlı gözlemde trafik, işlev ve sürüm bilgisini birleştirin
Yayın sonrası gözlem, yalnız sunucunun yanıt verdiğini görmekle sınırlanmamalıdır. Başarısız istekler, yanıt süreleri, arka plan işlerinin durumu ve kritik görevlerin sonucu birlikte değerlendirilir. Mümkünse gözlem kaydı sürüm kimliğiyle ilişkilendirilir. Ancak her olayı sürüme bağlamak da doğru değildir; dış sağlayıcı kesintisi veya trafik değişikliği gibi etkenler ayrıca incelenmelidir. Karar için kullanılan verinin zaman aralığı ve sınırları belirtilmelidir.
Web sitesi bakım planında yayın sonrası gözetimin sahibi açık olmalıdır. Sürüm çıkaran kişinin çevrimdışı olduğu durumda kim karar verecek, iş birimi kime ulaşacak? Bu soruların yanıtı dosya dağıtımından farklı bir hazırlıktır. İzlenecek göstergeler ile müdahale yetkisi ayrı kişilere aitse iletişim yolu ve vekil sorumlu da kayda eklenmelidir.
Aylık web sitesi raporunda sürüm tarihi, değişen görevler, gözlenen sorunlar ve kapanan bulgular birlikte izlenebilir. Yapılmayan kontrol için olumlu durum kullanmayın. Yayının teknik olarak etkin olması, iş birimi kabulünün veya bütün dış entegrasyonların doğrulandığı anlamına gelmez. Her sonuç kendi kanıtıyla kapatıldığında sonraki ekip aynı sorunları yeniden keşfetmek zorunda kalmaz.
Yayını ortak bir kabul ve sorumluluk kaydıyla kapatın
Geçiş tamamlandığında sürüm kimliği, uygulanan adımlar, değişen veri yapısı, gözlem sonucu ve açık işler tek yerde bulunmalıdır. Geçici erişimler ile kullanılmayan test kaynaklarının durumu da kontrol edilir. Buna karşılık hata kanıtlarını kaldırıp süreci yalnız başarılı görünür hale getirmek doğru bir kapanış değildir. Gerekli kayıtlar uygun kapsamda korunmalı, hassas veriler ise raporlarda gereksiz biçimde tutulmamalıdır.
Web danışmanlığıyla geçiş kapsamını değerlendirirken hedef, bütün projelere aynı dağıtım şablonunu uygulamak olmamalıdır. Mevcut panel yapısı, veri ilişkileri, ekip yetkileri ve bakım anlaşması birlikte ele alınmalıdır. Web Tasarım Sistemleri ile bu çerçeveyi konuşmak için projenizin teknik kapsamını paylaşın. Görüşmeye erişim sırları yerine ortam haritası, sürüm değişikliği özeti ve varsa açık test bulgularıyla başlamak, değerlendirmeyi somut bir çalışma planına dönüştürür.
Bu makalenin uzunluğu 1863 kelimedir.
Bu makale 2026-11-08 tarihinde yayınlanmıştır.