Orbit'te Branch Preview Dağıtımları

Branch previews build every non-production, non-staging branch you push to its own isolated URL, so you can click through a change in a real environment before it merges. This guide covers turning…

Şube Önizlemelerini Etkinleştirme

Projenizi Orbit içinde açın.
Settings sekmesini açın.
Runtime bölümünü bulun ve Branch previews seçeneğini açın.

Etkinleştirildikten sonra, üretim dalınız veya hazırlık dalınız olmayan herhangi bir dala yapılan her itme bir derlemeyi tetikler ve bunu kendi önizleme ortamına dağıtır.

Orbit proje ayarlarında şube önizlemeleri geçişi

Şube önizlemeleri proje başına bir geçiş olup, ücretli bir eklenti değildir. Tüm Orbit planlarında (ücretsiz Launch planı dahil) mevcuttur. Plan tarafından farklılık gösteren şey, tek bir projenin aynı anda kaç ortama sahip olabileceğidir: Launch 2'ye izin verir (üretim artı bir önizleme), Liftoff 4'e ve Apex 11'e izin verir. Bir proje ortam sınırına ulaştığında, birini silene kadar başka dallar kendi önizlemesini almayacaktır.

Önizleme URL'leri

Önizleme, dal adından türetilen bir ana bilgisayar adı alır: ad küçük harfe dönüştürülür, harf, rakam veya tire olmayan her karakter tire haline gelir, tire dizileri çöker ve sonuç 48 karaktere kesilir ve branch- ile ön eke sahip olur.

Dal	Önizleme ana bilgisayar adı
`redesign`	`branch-redesign.kaps.run`
`feat/new-checkout`	`branch-feat-new-checkout.kaps.run`
`JB/Fix_Cart`	`branch-jb-fix-cart.kaps.run`

Önizleme URL'leri bağlantıya sahip olan herkes tarafından genel olarak erişilebilir. Dizine alınmaz veya duyurulmaz, ancak erişim denetimine tabi değildir. Takımınızı terk etmemesi gereken hiçbir şeyi gözden geçirmek için önizlemeyi kullanmayın ve bir önizlemeyi üretim verilerine işaret etmeyin. Korumalı bir ön-üretim ortamına ihtiyacınız varsa, bunun yerine bir staging ortamı kullanın: staging, Settings içinde Staging: access protection ve Staging: IP allowlist bölümleri altında bir parola ve IP beyaz listesini destekler.

Önizlemelerin Görüneceği Yer

Proje Overview sekmesinde her etkin önizlemeyi listeleyen bir Preview deployments bölümü bulunur. Her satır şunları gösterir:

Dal adı ve dal açık bir çekme isteğine sahip olduğunda çekme isteğine bağlanan bir PR #number rozeti
Geçerli durum (QUEUED, BUILDING veya canlı)
Ne kadar önce dağıtıldığı
Önizleme URL'sini açmak için bir bağlantı
Dağıtım ayrıntı sayfasını açmak için View logs
Silme düğmesi

Her önizleme, kendi URL'si, kendi derlemesi ve kendi ortam değişkenleri ile tamamen izole bir ortamdır. Yaptığı hiçbir şey üretimi etkileyemez.

Proje Branches sekmesi, aynı bilgiyi dal başına düzenlenmiş şekilde verir; bu, aynı anda birkaç tane açık olduğunuz zaman tarama yapmak daha kolaydır.

Önizlemelerde Ortam Değişkenleri

Bu, doğru anlaşılması gereken kısımdır. All environments (project-wide) kapsamına sahip bir değişken, önizleme derlemelerine enjekte edilir ve bir önizleme URL'si geneldir.

Üretim kimlik bilgilerini yalnızca üretim ortamınız kapsamında tutun.
Üçüncü taraf hizmetleri için önizlemelere test modu veya korumalı alan kimlik bilgileri verin.
Bir üretim veritabanı URL'sini veya canlı bir ödeme anahtarını proje genelinde kapsamda bırakmayın.

Tam mekanikler, üretim yalnızca bir değişkeni nasıl ekleneceği ve hazırlama mirasının nasıl çalıştığı dahil, Setting Environment Variables Per Environment içinde yer almaktadır.

Bir Önizleme için Derleme Günlükleri

Herhangi bir önizlemenin yanında View logs seçeneğine tıklayın ve dağıtım ayrıntı sayfasını açın. Önizlemeler, üretim dağıtımları ile aynı şekilde işlem görür: tam akışlı derleme günlüğü, derleme aşamaları, taahhüt ve yazar, yapı boyutu, önbellek isabet veya soğuk derleme, algılanan çerçeve ve paket yöneticisi ve bir derleme başarısız olduğunda yapay zeka tanı düğmesi.

Bir Önizlemeyi Silme

Önizleme satırındaki silme düğmesine tıklayın ve onaylayın.

Bir önizlemeyi silme, ortamı ve tüm derleme geçmişini kaldırır, yalnızca geçerli dağıtımı değil. Geri alınamaz. Dal kendisi dokunulmaz, bu nedenle ona tekrar itme işlemi yapıldığında sıfırdan yeni bir önizleme oluşturur; tarih olmadan ve soğuk bir derleme önbelleği ile.

Otomatik Temizleme

Kendinizden sonra temizlemeniz gerekmez.

Bir çekme isteği kapatıldığında veya birleştirildiğinde, önizleme ortamı hemen duraklatılır ve sunmayı durdurur. Ziyaretçiler eski bir derleme yerine 404 alırlar.
Bir dalı silme, o dalın önizlemesini aynı şekilde duraklatır.
Duraklatılan önizlemeler yaklaşık bir gün sonra çöp olarak toplanır: kaynak tarballeri, derleme yapıtları ve derleme önbellekleri silinir ve ortam arşivlenir.

Ayrıca bir zamanlamaya göre önizlemelerin süresi dolmasını da ayarlayabilirsiniz. Settings içinde Preview expiry seçeneğini bulun ve Asla, 7, 14, 30 veya 60 gün seçin. Bundan daha eski önizlemeler otomatik olarak duraklatılır ve 24 saat içinde temizlenir.

Yoğun bir depoda, Preview expiry seçeneğini 14 veya 30 güne ayarlayın. Her etkin önizleme projenizin ortam sınırına karşı sayılır ve süresi dolmuş olanlar, yeni bir dalın sessizce bir önizleme alamamasının olağan nedenidir.

Onay ve Önizlemeler

Deploy protection altında Require approval for production etkinleştirilirse, yalnızca üretim için geçerlidir. Önizleme derlemeleri onay için tutulmaz.

Belirli bir önizlemenin silmeden daha fazla değişiklik dağıtmasını durdurmak için, Environments sekmesinden ortamı duraklatın. Duraklatılmış bir ortama yeni dağıtımlar, bunu sürdürene kadar atlanır.

Sorun Giderme

Bir dal itildi ancak önizleme görünmedi. Şu sırayla kontrol edin: Settings içinde Branch previews açık mı, Runtime sekmesi mi? Dal gerçekten hazırlık dalınız mı (hazırlık, hazırlamaya dağıtılır, önizlemeye değil)? Dal, Branch ignore patterns numaralı seçeneklerden birine uyuyor mu, örneğin dependabot/*? Proje zaten planınız için ortam sınırında mı?

Önizleme derlendi ancak 404 gösteriyor. Derleme başarılı oldu ancak çıkış dizini muhtemelen bu dal için yanlış. Settings içinde Output directory seçeneğini kontrol edin ve bir dalın ayarını değiştirmeden derleme çıkışını değiştirebileceğini unutmayın. Configuring Your Build Command and Output Directory başlıklı makaleyi görmek için tıklayın.

Önizleme daha eski bir taahhütü gösteriyor. Aynı dal için bir derleme çalıştırılırken yeni bir taahhüt itilmesi, uçuşa devam eden derlemeyi iptal eder ve yeni bir taneyi başlatır. İptal edilen bir dağıtım ve ardından çalışan bir dağıtım görürseniz, bu beklenen bir durumdur. İkinci derlemenin tamamlanmasını bekleyin.

Kapatılan PR'nin önizlemesi hala erişilebilir. Duraklatma web kancası olayında gerçekleşir. PR'yi kapattığınızda sağlayıcı bağlantısı bağlantısı kesildi, olay asla gelmedi. Genel Bakış sekmesinden önizlemeyi el ile silin.

İlgili Okuma

Projenizi Dağıtma
Ortam Başına Ortam Değişkenleri Ayarlama
Orbit Plan Sınırları her plandaki ortam indirimi için