Mini ders · Türkçe

Yayımlamadan önce site değişiklikleri nasıl önizlenir

Asistanla küçük bir web sitesi değişikliği hazırlayın, ayrı önizleme adresini inceleyin ve onaya kadar canlı sürüme dokunmayın.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Depodan yayımlama yapan ve değişiklikleri çıkıştan önce incelemek isteyenler için. Dal işlemlerini kodlama asistanı ve depo/barındırma araçları yapabilir.

Başlamadan önce

Pull request önizlemeleri etkin, Netlify alıştırma projesine bağlı, size ait ayrı bir GitHub deposu. Bulut derlemeleri hesap kredisi kullanır. Atölye önce/değişiklik dosyalarını sağlar; gerçek canlı değişiklik yerine gözden çıkarılabilir site kullanın.

Tahmini süre: 20–32 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Bulut derlemesinde bekleme ve hesap kurulumu ek süre alır. Herkese açık önizlemelerde özel test verisi veya üretim sırrı bulunmamalıdır.

Neler öğreneceksin?

  • Ayrı bir inceleme sürümü oluşturun.
  • Önizlemeyle mevcut siteyi aynı görevle karşılaştırın.
  • Onayı gerçekten incelenen sürüme bağlayın.

Uygulama dosyaları

Adım 1

İki sürümü belirleyin

İnceleme hem başlangıç noktası hem önerilen değişiklik gerektirir.

Ayrı deneme barındırma projenizde P1’i oluşturmak için sağlanan başlangıç sayfasını kullanın. Asistanla bunu sağlanan değişiklik sayfasıyla karşılaştırın: P1’de “Find contact information”, P2’de “Contact me” yazar. İkisi aynı Contact bölümüne ulaşmalı.

Şu an yayımlanan P1 adresini başlangıç karşılaştırması olarak tutun. Önerilen P2, birleştirilmemiş inceleme dalında ve ayrı önizlemesinde durmalı; test ettiğiniz sayfayı tanımak için görünür sürüm işaretlerini kaydedin.

Somut bir örnek

Bu yeni iletişim sistemi değil, küçük ifade değişikliği. Mevcut iletişim hedefi çalışmaya devam ederken önerilen etiket daha açık hâle gelmeli.

Verilen alıştırma sitesi değişikliğini kullan. Mevcut yayımlanmış alıştırma sürümünü değiştirmeden Netlify önizlemeli ayrı inceleme dalı ve pull request hazırlamama yardım et. İki URL'yi göster ve incelenen sürümü belirt. Onayım olmadan birleştirme veya canlıya yayımlama. Değişen görevi sınamama ve çözülmemiş sorunları kaydetmeme yardım et.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Değişikliği yayımlamadan önce önizleyin

Canlı site çalışmayı sürdürürken önerilen sürüme kendine ait bir inceleme URL’si verin.

Önizleme, dalı üretim kaynağına birleştirmeden önce gerçekten derlenmiş sonucunu test etmenizi sağlar. İyi görünen yerel dosyanın derleme yolları veya ortam ayarları yine de yanlış olabilir.

Bu atölyede bilinçli olarak küçük bir değişiklik yapılır: P1’de “Find contact information”, P2’de “Contact me” yazar. İki sürümü belirleyip birleştirmeye karar vermeden önce her ikisinde de aynı iletişim bilgisine ulaşma işlemini kontrol edeceksiniz.

Çözülmüş örnek

Pull request birleştirilmemişken önizleme P2’yi, normal herkese açık site ise hâlâ P1’i göstermelidir. İkisi de değiştiyse üretime hangi dalın dağıtıldığını araştırın.

Extra implementation exercise

İnceleme kaydınız neden hem önizleme hem üretim sürümünü içermeli?

Çözülmüş örneği göster

Önizlemenin önerilen değişikliği içerdiğini, herkese açık sitenin ise onaylanmış sürümü koruduğunu ortaya koyar. Yalnızca çalışan önizleme bu ayrılığı kanıtlamaz.

  • Hangi sürümün incelendiğini kanıtlar.
  • Üretimin yanlışlıkla değiştirilmediğini doğrular.

Adım 2

İnceleme önizlemesi oluşturun

Depo adımlarında asistan yol göstersin.

Ayrı deneme deposunu kullanın; barındırma hesabında pull request önizlemelerini etkinleştirin. Sağlanan P2 değişikliğiyle inceleme dalı oluşturmasını, dalı push etmesini ve birleştirilmemiş pull request açmasını asistandan isteyin. Bu barındırılmış derlemeler hesap kredisi kullanabilir.

Oluşan önizlemeyi açıp görünür P2 işaretini okuyun. Önizleme adresini, depodan veya barındırma hizmetinden alınan tam incelenmiş commit ile kaydedin. Aynı daldaki sonraki commit incelenecek yeni sürümdür.

Somut bir örnek

improve-contact-label adlı dal zaman içinde farklı commit’ler içerebilir. İlk önizlemesinin onayı, sonraki commit’i otomatik kapsamaz.

Netlify: Deploy Previews

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tekrarlanabilir bir değişiklikle dal incelemesi açın

Pull request’i belirli bir kaynak sürümüne bağlayın.

commands.txt yönergelerini yalnızca kendi gözden çıkarılabilir deponuzda izleyin. P2 değişikliğini dalda commit edin ve birleştirmeden pull request açın. Netlify Deploy Preview, derlenmiş URL’yi o pull request/sürümle ilişkilendirmelidir.

Tarayıcıdan başarı çıkarmak yerine dağıtım ayrıntılarını okuyun. Commit’i kaydedin ve yayımlanan dizini kontrol edin. Önizleme yoksa proje önizleme ayarlarını ve derleme günlüklerini inceleyin; telafi etmek için dalı üretime yayımlamayın.

Dal komutlarından önce mevcut P1 herkese açık URL’sini açın, iletişim bağlantısına tıklayın ve çalışan P1 commit’ini review-record.csv içine kaydedin. Çalışan P1 dağıtımı yoksa önce bu başlangıç durumunu tamamlayın. Ödev için iki satırı da doldurun: kontrol edilen ortam, URL, commit, görünen sürüm, iletişime ulaşma sonucu ve beklenmeyen yan etki.

Çalışırken üretim dalı değişirse devam etmeden önce pull request’in güncelleme/çakışma durumunu inceleyin. Güncel dal durumunu alın ve varsa çakışmayı kendi dalınızda bilinçli biçimde çözün; emin değilseniz ilgisiz çalışmanın üzerine yazmak yerine yardım isteyin. Çözdükten sonra yeni önizleme sürümünü yeniden inceleyin.

Önizleme URL’si yoksa depo pull request’lerinde Deploy Previews özelliğinin açık olduğunu, dalın hariç tutulmadığını, derleme günlüğünün başarılı olduğunu ve netlify.toml dosyasının amaçlanan public dizinini gösterdiğini kontrol edin. Sağlayıcının Deploys geçmişinde geçerli üretim dağıtımını açıp gerçek kaynak commit’ini bulun.

Çözülmüş örnek

Yeşil commit kontrolü ve açılan önizleme aynı sürüme ait olmalıdır. Sonradan dalı düzenlemek kendi incelemesini gerektiren yeni sürüm oluşturur.

Netlify: Deploy Previews

Extra implementation exercise

A commit’ini incelediniz, sonra aynı dala B commit’ini push ettiniz. Eski onay B’yi kapsar mı?

Çözülmüş örneği göster

Hayır. Dal adı aynı kaldı ama içerik değişti. B’den derlenen önizlemeyi kontrol edip farkları inceleyin.

  • İncelemeyi belirli bir sürüme bağlar.
  • Yayıma almadan önce değişen önizlemeyi yeniden test eder.

Adım 3

Ziyaretçi görevini güvenli biçimde tekrarlayın

Farklı ana makine adı gerçek hizmetleri zararsız yapmaz.

Yayımlanmış P1 ve önizleme P2’yi oturum kapalı ve dar genişlikte açın. İkisinde de iletişim işlemini kullanıp Contact bölümünün erişilebilir kaldığını kontrol edin. Sağlanan statik örnekte iletişim hedefinde durun; örnek adrese e-posta göndermeyin.

Tekniği sonra formlara, ödemelere veya saklanmış verilere uygularsanız önce önizlemenin hizmet ayarlarını inceleyin. Yeni önizleme alan adı yine gerçek hizmeti çağırabilir; bu etkiler için ayrı test hesapları ve verileri kullanın.

Somut bir örnek

Sağlanan örnekte P1 ve P2, Contact bölümüne ulaşır; P2 yalnızca görünür bağlantı etiketini ve sürüm işaretini değiştirir. İki sürüm de e-posta göndermek veya veritabanı kaydı yazmak zorunda değildir.

Netlify: ortam değişkenleri ve dağıtım bağlamları · Netlify: dağıtım bağlamına göre ortam değişkenleri

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Önizleme verilerini ve yan etkilerini ayırın

Farklı URL, arka ucu kendiliğinden ayırmaz.

Statik iletişim bağlantısı örneğimizde arka uç yan etkisi yoktur. Gerçek uygulamada önizleme bağlamındaki değişkenleri ayrı inceleyin: veritabanı, e-posta alıcısı, ödeme modu ve kimlik bilgileri hâlâ üretimi gösterebilir.

Gerektiğinde gözden çıkarılabilir test verisi ve sağlayıcı sandbox ortamları kullanın. Sıradan ziyaretçilerin görmesine karşı korunan önizleme bile yapılandırdığınız kimlik bilgileriyle sunucu işlevi çalıştırabilir.

Örneğin işleviniz SUPABASE_URL okuyorsa değişkenin aynı adını koruyun ama Deploy Preview bağlamındaki değerini gözden çıkarılabilir veritabanı projesine ayarlayın. Kodun hiç okumadığı yeni bir değişken adı uydurmayın. Bu bağlamdaki her sırrı, alıcıyı ve ödeme modunu da inceleyin; üretim değerini kopyalamak ayrılığı ortadan kaldırır.

Netlify proje panelinde ortam değişkeni ayarlarını açın ve değişkenin Deploy Preview bağlamındaki değerini Production değerinden bağımsız düzenleyin. Bu bağlam için yalnızca test hizmeti değeri kaydedin, yeni önizleme derlemesi başlatın ve oluşan sürümü doğrulayın; panelde değer değiştirmek, önceden dağıtılmış işlevin onu aldığını kanıtlamaz. Aşağıdaki resmi bağlam rehberine bakın.

Çözülmüş örnek

Üretim posta sağlayıcısına bağlı önizleme iletişim formu gerçek mesaj gönderebilir. URL’de “preview” yazması o çağrıyı durdurmaz.

Netlify: ortam değişkenleri ve dağıtım bağlamları · Netlify: dağıtım bağlamına göre ortam değişkenleri

Extra implementation exercise

Benzersiz bir önizleme ana makine adı, test satın almalarının gerçek para çekemeyeceğini garanti etmeye yeter mi?

Çözülmüş örneği göster

Hayır. Önizlemeyi test kimlik bilgileri ve ayrı hizmetlerle yapılandırın, sonra gerçek davranışlarını doğrulayın. Ana makine adlarının farklı olması tek başına yetmez.

  • Ödeme kimlik bilgilerini/modunu ve veri hedeflerini kontrol eder.
  • Ön yüz URL’lerinin ayrılığını arka uçların yalıtılmasıyla karıştırmaz.

Adım 4

Sürüme özgü inceleme kararı verin

Onay, gerçekten incelediğiniz sonucu izler.

review-record.csv dosyasını URL'ler, incelenen sürüm, gözlemler ve kalan sorunlarla tamamlayın. Sınırlı düzeltme isteyin ve oluşan önizlemeyi yeniden inceleyin.

Açık bir yayımlama kararı verilene kadar mevcut siteyi değiştirmeyin. İncelemeden sonra sürüm değişirse nelerin yeniden sınanması gerektiğini belirtin.

Somut bir örnek

Yararlı inceleme somuttur: “P2’nin düzeltilmiş iletişim etiketi 390px ve masaüstünde aynı bölüme ulaşıyor; yayımlanmış başlangıç P1 olarak kalıyor.” Denenen sürümü belirtir ve pull request’i birleştirmez.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ödeviniz: incelenebilir bir değişiklik sunun

İncelemeyi küçük tutun ve gözlemlenebilir sonuçlarla destekleyin.

Dalda bir ek etiket veya yerleşim iyileştirmesi yapın. Önizlemesinde doğrudan açılmayı, mobil genişliği ve iletişime ulaşmayı kontrol edin. Üretim sürümüyle karşılaştırın.

Önizleme URL’si, kaynak sürümü ve gözlemlerle kısa değişiklik açıklaması verin. Yalnızca amaçlanan inceleyici gerçek sürümü onayladıktan sonra birleştirin; bu alıştırmada üretime geçiş gerekmiyor.

Dar ekran kontrolünde tarayıcı geliştirici araçlarında 390px görünüm genişliği, ardından masaüstü genişliği kullanın. Gerçek genişliği ve iletişime ulaşma sonucunu review-record.csv içine kaydedin; bu ödevde dal birleştirilmeden kalır.

Çözülmüş örnek

“İletişim etiketini değiştirdim; bağlantı 390px ve masaüstü genişliğinde hâlâ #contact hedefine ulaşıyor” ifadesi, “daha iyi görünüyor” demekten daha yararlıdır.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Extra implementation exercise

Üretimi değiştirmeden dal önizlemesi ve tamamlanmış karşılaştırma kaydı oluşturun.

Çözülmüş örneği göster

P1’in deneme sitesinin herkese açık URL’sinde zaten çalıştığını doğrulayın ve commit’ini kaydedin. İnceleme dalında görünen işareti P2’ye, iletişim etiketini “Contact me” metnine değiştirin; kendi hesabınızda o dalı commit/push edip birleştirilmemiş pull request açın.

review-record.csv içine iki satırı kaydedin: üretim URL’si/commit/P1/iletişim çalışıyor; önizleme URL’si/yeni commit/P2/iletişim çalışıyor. İkisini de oturum kapalıyken ve dar genişlikte açın. Önizlemenin yan etkileri varsa arka uç ayarları ayrı test hizmetlerini göstermelidir. Aynı kontrolleri 390px ve masaüstü genişliğinde tekrarlayın; ayrı CSV satırları kullanıp her gerçek genişliği kaydedin.

Dalda başka bir commit’ten sonra o yeni önizleme sürümünü yeniden kontrol edin. Örnek istek açıklaması, inceleyicinin ihtiyaç duyduğu bilgileri gösterir; bu ödevde dalı birleştirmeyin ve üretime geçiş yapmayın.

  • İnceleme sırasında üretim onaylanmış sürümünde kalır.
  • Önizlemenin tam olarak belirtilen sürümünde ziyaretçi istenen iletişim bilgisine ulaşabilir.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin