Kapsule Orbit Proje Ayarları

Bir Orbit projesinin her ayarı Settings sekmesinde yer alır ve gruplandırılmıştır: genel bilgiler, derleme ve dağıtım, güvenlik, bildirimler, entegrasyonlar, kullanım limitleri, dağıtım otomasyonu, ağ iletişimi, gözlemlenebilirlik, paylaşım ve altta yer alan tehlike bölgesi.

Settings Nerede Yer Alır

Orbit öğesini açın, projeyi tıklayın ve proje sekme şeridinde Settings öğesini seçin. Sayfa projeniz adını, derleme komutlarını ve Git entegrasyonunu yapılandırmak olarak tanımlar; bu, gerçekte neler yapılabileceğini eksik gösterir.

Bu kılavuz bir haritadır. Konunun kendi makalesi varsa bağlantı verilir, tekrar edilmez.

Genel

Proje bilgisi URL slug'ını, oluşturma tarihini, bağlı depoyu ve üretim URL'sini gösterir ve projenin Name ve Description öğelerini değiştirmenize olanak sağlar.

Git, Production branch öğesini tutar. Bu dala yapılan push'lar üretim dağıtımlarını tetikler.

Status badge, yayında dağıtım durumunun canlı bir SVG'sini sağlar ve README'nize yapıştırmaya hazır URL, markdown ve HTML için kopyalama düğmeleriyle birlikte gelir. Bkz. Orbit'te Proje README'nizi Görüntüleme.

Public status page, durum sayfası yapılandırmasına bağlantı verir. Bkz. Orbit Status Page.

Derleme ve Dağıtım

Build settings, Orbit'in otomatik olarak algıladığı ve geçersiz kılabileceğiniz beş alandır: yükleme komutu, derleme komutu, çıktı dizini, kök dizin ve Node.js sürümü. Algılanan değeri tutmak için bir alanı boş bırakın. Tam ayrıntılar Derleme Komutunuzu ve Çıktı Dizininizi Yapılandırma bölümündedir.

Runtime, anlamaya değer dört anahtar içerir:

• Server mode, her dağıtımdan sonra başlama komutunuzu çalıştıran derleme makinesini canlı tutar. Statik dosyaları dışa aktarmak yerine sunucuda işlenen her şey için gereklidir.
• Branch previews, üretim veya hazırlama olmayan her dal push'u için otomatik olarak bir ortam oluşturur; her biri branch-*.kaps.run altında kendi URL'sinde yer alır. Bkz. Branch Previews.
• Auto-rollback on failure, bir dağıtım başarısız olursa son sağlıklı üretim dağıtımını geri yükler.
• Scheduled rebuild, saatlik ila haftalık aralıktan saatlik olarak üretimi yeniden derler; bu, bir git push'u olmadan yenilemeye ihtiyaç duyan içerik yönetilen siteler için uygundur.

Build auto-retry, ağ sorunu veya zaman aşımı gibi altyapı hatalarından kaynaklanan başarısız derlemeleri en fazla üç kez yeniden sıraya alır. Kod hatalarını yeniden denemez, bu nedenle kırık bir derlemeyi gizleyemez.

Ignored paths ve Branch ignore patterns, ihtiyacınız olmayan derlemeleri durdurun: değişiklikleri dağıtmaması gereken dosyalar için glob desenleri ve dependabot/* gibi dallar için hiçbir zaman birini tetiklememelidir.

Git tag deploys, etiket push'unu bir üretim dağıtımına dönüştüren etiket desenini ayarlar. Bkz. Orbit Releases.

Dağıtım Otomasyonu ve Koruması

Deploy protection iki geçide sahiptir: Require approval for production, push tarafından tetiklenen üretim dağıtımlarını birinin onaylaması için duraklatır ve Require staging success before production, aynı işleme başarıyla dağıtana kadar üretimi tutar.

CI required checks, dağıtımları kendi CI'nize göre yapar. GitHub'da iş adlarını listelersiniz; hepsi geçmeli; GitLab'da boş olmayan herhangi bir değer tüm ardışık düzeni bekler. Bir CI hatası dağıtımı iptal eder.

Deploy freeze schedule, onaylı pencereler dışında push tarafından tetiklenen dağıtımları engeller; hafta sonları veya bir UTC saat aralığı. El ile dağıtımlar ve dağıtım hook'ları etkilenmez.

Branch protection, eşleşen dallara dağıtımı gerekli harici kontroller geçene ve isteğe bağlı olarak bir kişi onaylayana kadar engelleyen glob deseni kuralları ekler.

Auto-promote staging, sağlık hatası olmadan yapılandırılan saat sayısı boyunca çalıştıktan ve smoke testleri geçtikten sonra hazırlamayı otomatik olarak üretim alanına yükseltir.

Bunların hepsi Orbit Deployment Pipeline sekmesinde bir görünüme özet olarak verilir.

Sağlık ve Kalite Geçitleri

Health check, her üretim dağıtımından sonra seçtiğiniz bir yolu getirir. 15 saniye içinde 2xx olmayan bir yanıt önceki sağlıklı dağıtımı geri yükler.

Smoke tests, her başarılı dağıtımdan sonra en fazla on virgülle ayrılmış yola karşı GET isteklerini çalıştırır ve geç/başarısız kaydetler. Auto-rollback ile birlikte, başarısız bir smoke testi dağıtımı geri alır.

Performance budgets, eşiği aşan derlemeleri uyarır veya başarısız kılar: MB cinsinden toplam artefakt boyutu, glob ile eşleşen kB cinsinden bireysel dosya boyutu veya saniye cinsinden derleme zamanı. Her bütçe, derlemeyi uyarmak veya başarısız kılmak üzere ayarlanır.

Hazırlama

Hazırlama kendi kart setine sahiptir: staging branch, parola ile access protection, IPv4 adresleri ve CIDR aralıklarını satır başına bir tane kabul eden IP allowlist, auto-rollback on failure, hazırlamanın inherits production environment variables öğesini daha düşük öncelikle ve build overrides yükle, derle, çıktı ve kök dizin.

Parola ve IP allowlist, herkese açık olmayacak şekilde tasarlanan herhangi bir hazırlama ortamında ayarlanacak iki şeydir. Her ikisini de boş bırakın ve hazırlama URL'si onu alan herkes tarafından erişilebilir.

Ağ İletişimi

Custom domains, üretim ortamı için alanları ekler ve doğrular; sertifika sağlamayı dahildir. Bkz. Orbit'e Özel Alan Adı Ekleme.

Redirects and rewrites sunulmadan önce uygulanır yol tabanlı kurallardır; sırayla test edilir ve ilk eşleşme kazanır. Bir yönlendirme tarayıcıyı yeni bir URL'ye 301 veya 302 olarak gönderir; bir yeniden yazma URL değişikliği olmadan sessizce farklı bir yolu sunar. Desenler tam eşleşmeleri, joker kartları, adlandırılmış parametreleri ve splitleri destekler. Bkz. Orbit'te Yönlendirmeler ve Yeniden Yazımlar.

Response headers, önceden ayarlanmış HSTS, CSP, no-embed, no-sniff, referrer policy ve CORS ile eşleşen yollara özel HTTP başlıkları uygulanır. Tüm eşleşen kurallar uygulanır ve aynı anahtar için daha sonraki girdiler önceki olanları geçersiz kılar.

Skew protection, yeni bir dağıtım aktif olduktan sonra eski derleme yapıtlarını bir bekletme penceresinde depolamada tuttuğundan, önceki sürümü yükleyen bir ziyaretçi 404 almak yerine varlıklarını hala getirebilir.

The config store, dağıtımınızın çalışma zamanında okuduğu anahtar/değer ayarlarını tutar; özellik bayrakları ve yeniden dağıtım olmadan değişen ayarlar için. Storage altında yönetilir, burada değil ve ücretsizdir: okuma ücreti yok ve yazma ücreti yok. Değerler düz metin olarak depolanır, bu nedenle gizli dizini hiçbir zaman buna koymayın. Proje başına en fazla 100 giriş; anahtarlar en fazla 200 karakter ve değerler en fazla 4096. Her girişin bir gece anlık görüntüsü alınır ve her planda otuz gece saklanır; bu nedenle sildiğiniz bir giriş geri alınabilir: bkz. Snapshots and restore.

Kullanım ve Limitler

Build usage, bu projenin çalıştırdığı derlemeleri gösterir.

Spending cap, plan tahsisinin ötesinde derleme dakikası ve bant genişliği aşımlarını kapsayan aylık aşım harcamasının maksimumunu ayarlar. Minimum US$6.32 ve maksimum US$6,315.79 dir. Uyarılar %50 ve %80'de ateşlenir ve %100'de hizmet sunma durdurulur; cap'i yükseltene kadar. Bkz. Orbit Spending Cap.

Build spending cap, ayrı, daha kaba sınırdır: aylık toplam derleme dakikaları tavanı; sonrasında yeni derlemeler sonraki aya kadar sıraya girmez veya cap'i yükseltirsiniz.

Artifact retention, ortam başına kaç başarılı derleme yapıtı tutulacağını ayarlar. Eski olanlar günlük silinir ve şu anda canlı dağıtım limit ne olursa olsun her zaman tutulur.

Preview expiry, 7, 14, 30 veya 60 gün sonra veya asla; önizleme ortamlarını duraklatır. Duraklatılmış önizlemeler depolama alanlarını 24 saat içinde geri alırlar.

Artifact size alert, bir derleme yapıtı ayarladığınız bir boyutu aştığında sizi e-postalar.

Bildirimler, Entegrasyonlar ve Gözlemlenebilirlik

Deploy email notifications üç ayara sahiptir: tüm dağıtımlar, yalnızca hatalar veya kapalı. Bir notification webhook URL onun yanında ayarlanabilir, her başarıda veya başarısızlıkta gönderir.

Notification channels, olay başına seçim, teslimat geçmişi ve test düğmesi ile daha zengin versiyondur. Tam webhook kontrolü kendi sekmesindedir: bkz. Orbit Webhooks.

Deploy hooks, bir şey onlara POST yaptığında bir dağıtımı tetikleyen gizli URL'ler oluşturur. Bkz. Deploy Hooks Aracılığıyla Dağıtımları Tetikleme.

Log drains derleme günlüklerini her dağıtımdan sonra gözlemlenebilirlik platformunuza gönderir; Datadog, Logtail, Axiom ve New Relic için yerleşik destek veya özel webhook ile isteğe bağlı olarak bir ortama filtrelenir.

Web Analytics Core Web Vitals toplama parçacığını sağlar. Bkz. Orbit Web Vitals.

Cron triggers seçilen ortama HTTP isteklerini zamanlar; proje başına en fazla on. Daha büyük, sadece üretim sürümü kendi sekmesindedir: bkz. Orbit Cron Jobs.

Paylaşım ve Ekip

Team işbirlikçileri yönetir; üç rol ile: yönetici, geliştirici ve görüntüleyici.

Share links, bir harici gözden geçiren parolasız ve hesapsız bir ortamı görüntüleyebilmesi için geçici parolasız bağlantılar oluşturur. Her bağlantı 1 saat, 24 saat, 7 gün içinde veya asla sona erebilir ve ziyaret sayısını gösterir. İstediğiniz zaman birini iptal edin.

Deployment group, bu projeyi gruba katılır; ilgili projeler birlikte dağıtılsın; isteğe bağlı olarak dal tarafından filtrelenmiş.

Clone environment ve Clone project yapılandırmayı çoğaltır. Bir projeyi klonlamak derleme ayarlarını, ortam yapılandırmasını ve gizli olmayan ortam değişkenlerini kopyalar; gizli dizinler kopyalanmaz.

Tehlike Bölgesi

Clear build cache, her ortam için önbelleğe alınan bağımlılıkları siler; bu nedenle sonraki dağıtım sıfırdan tam bir yükleme çalıştırır. Geri alınamaz; cache, sonraki derleme sırasında kendini yeniden oluşturur.

Transfer project, projeyi başka bir Kapsule hesabına taşır. Bkz. Bir Orbit Projesini Aktarma.

Archive project, trafiği sunmayı hemen durdurur. Orbit listesinden 30 gün içinde geri yüklüyle erişilebilir; bundan sonra kalıcı olarak silinir.

Sonra Nereye Gitmeli

• Orbit Deployment Pipeline her ayarın etkisini bir görünümde görmek için.
• Shared Environment Variable Groups projeler arasında kullanılan değerler için.
• Orbit Plan Limits planınızın neyin izin verdiği için.