Orbit
Build Günlüklerini Görüntüleme
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Her Orbit dağıtımı tam yapı günlüğünü, yapının neler yaptığının yapılandırılmış bir dökümünü ve her aşamanın ne kadar sürdüğünü tutar. Bu rehber günlüğü nerede bulacağınızı, çevredeki meta verileri nasıl okuyacağınızı ve Orbit'in günlük üzerinde çalıştırdığı analizi kapsar.
En Son Dağıtım İçin Günlüğü Görüntüleme
Projeyi Orbit'te açın. Overview sekmesindeki Latest build paneli en son dağıtımın günlüğünü gösterir. Şu anda bir yapı çalışıyorsa, günlük canlı olarak, satır satır, yapı ajanı ürettiği için aktarılır.
Full details'e tıklayarak tam dağıtım detay sayfasını açın.
Belirli Bir Dağıtım İçin Günlükleri Görüntüleme
- Projenizi Orbit'te açın.
- Deployments sekmesini açın.
- Detay sayfasını açmak için herhangi bir dağıtıma tıklayın.
- Tam yapı günlüğü o sayfada bulunur.
Overview sekmesindeki Recent deployments listesi her satırda aynı yere giden View logs bağlantısı içerir. Önizleme dağıtımlarının Preview deployments bölümünde de aynı bağlantı vardır.
Yapı Aşamaları
Detay sayfası yapıyı adlandırılmış aşamalar ve her biri için bir süre ile ayırır:
| Aşama | Neler olur |
|---|---|
| Clone | Depoyu dağıtılan commit'te alıntılama |
| Cache restore | Önbelleği açma node_modules, yapı önbelleğine sahip planlarda |
| Install | Yükleme komutunuzu çalıştırma |
| Cache save | Sonraki yapı için node_modules yeniden paketleme |
| Build | Yapı komutunuzu çalıştırma |
| Upload | Çıktı dizinini paketleme ve yapıyı depolama |
| Done | Yapı trafiğin önünde |
Bu "o yapı neden yavaştı" sorusuna cevap vermenin en hızlı yoludur. Cold build rozeti olan uzun Install aşaması, önbelleğin kaçırıldığı anlamına gelir. Uzun Build aşaması kendi yapınızın yavaşladığı anlamına gelir.
Yapı Meta Verileri
Günlüğün üstündeki kartlar dağıtım hakkındaki gerçekleri gösterir:
| Kart | Neler gösterir |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back veya Awaiting approval |
| Commit | Bu dağıtımın oluşturduğu commit, sağlayıcıya bağlantı vererek |
| Branch | Geldiği git dalı |
| Author | Commit'i kimin ittiği |
| Build time | Toplam duvar saati süresi, kendi geçmişinize karşı Fast, Normal veya Slow derecelendirmesi ile |
| Artifact | Paketlenmiş çıktı boyutu, indirme bağlantısı ile |
| Framework | Orbit'in algıladığı çerçeve |
| Package manager | npm, yarn veya pnpm, kilitli dosyanızdan algılandı |
| Build cache | Cache hit veya Cold build |
| Build host | Hangi yapı ana bilgisayarı çalıştırdı |
| Queue position | Dağıtım hala sırada iken kuyruktaki yersiniz |
| Pull request | Önizleme dağıtımı için PR numarası |
| Health score | 100 üzerinden puan, kesintiler listelenerek |
Orbit'in Günlük Üzerinde Çalıştırdığı Analiz
Detay sayfası sadece metin döküğü değildir. Orbit günlüğü ayrıştırır ve önemli olanı yüzeye çıkarır.
- Build timeline aşama başına süreler ile.
- Slow build detected bir yapı kendi medyanınızdan önemli ölçüde yavaş olduğunda, yüzde ile ve son 10 yapıdan tipik zamanınız ile.
- TypeScript errors, ayıklanmış ve sayılmış, yapı tür kontrolünde başarısız olduğunda.
- Build analysis Next.js yapıları için: rotaya göre boyutlar, ilk yük JS'i ve statik, dinamik ve ISR rota sayıları.
- Bundle regression uyarıları bir rotanın ilk yük JS'i önceki dağıtıma kıyasla yüzde 20'den fazla büyüdüğünde veya paylaşılan JS paketi büyüdüğünde.
- npm audit sonuçları doğrudan kurulum çıktısından ayrıştırılmış, ciddiyet tarafından özetlenmiş.
- Security headers audit 60 puan üzerinden puanlandırılmış.
- Smoke test sonuçları, yapılandırdığınız dumanlandırma test yollarına sahip olmanız durumunda.
- Performance budgets aşıldı, bütçe belirlediyseniz.
- Build optimization advisor, somut değişiklikleri listeleyen, tahmini boyut tasarrufu ile, etkiye göre sıralanmış.
- Real user metrics, bu dağıtım canlıyken kaydedilen p75 Core Web Vitals.
Yapı Aslında Hangi Ortam Değişkenlerini Gördü
Detay sayfası, yapı zamanında enjekte edilen ortam değişkeni anahtarlarını listeler ve mevcut yapılandırmanıza karşı farklarını gösterir: eklenen, değiştirilen, kaldırılan, değişmeyen. Teal anahtarlar ortama özel geçersiz kılmadan, gri olanlar proje seviyesinden geldi.
Değerler hiçbir zaman depolanmaz ve hiçbir zaman gösterilmez. Bir anahtarın üzerine geldiğinizde, iki ortamın değeri ortaya çıkarmadan aynı sahip olduğunu onaylamak için yeterli olan bir SHA-256 parmak izi elde edersiniz.
Bu fark "ortam değişkeni değişikliğim yapıya girdi mi" sorusuna cevap vermenin en hızlı yoludur. Dağıtım değişiklikten önceki tarihlenmiş ise, Orbit bunu Environment variables updated since this deployment bildirimi ile söyler ve değişikliğin yeniden dağıtana kadar etkilemeyeceğini hatırlatır.
İki Dağıtımı Karşılaştırma
Önceki bire karşı farklarını çıkarmak için bir dağıtıma Compare'i tıklayın: yapı zamanı, yapı boyutu, önbellek durumu, çerçeve ve dosya seviyesi yapı farkı. Bu bir dağıtım öncekinden farklı davrandığında "aslında ne değişti" için en hızlı rotadır.
Bir Yapı Başarısız Olduğunda
Durum kartı Failed'e döner ve günlük nerede durduğunu gösterir. Günlüğün üstünde, Orbit kategorize edilmiş bir hata özeti ve önerilen düzeltme ekler. Tanınan kategoriler bellek yetersizliği, derleme hatası, test başarısızlığı, lint hatası, kurulum hatası, ağ hatası ve zaman aşımı içerir ve Orbit eksik modül, ERESOLVE eş bağımlılık çatışması, TypeScript hata kodu, tam yapı diski, paket 404 ve güncel olmayan kilitli dosya gibi belirli desenleri eşleştirir.
Ayrıca günlüğün son 120 satırını algılanan çerçeve ve hata kategorisiyle birlikte okuyan ve düz dil açıklaması döndüren Get AI diagnosis düğmesi de vardır.
AI tanısı nedense AI-generated, verify before acting olarak etiketlenmiştir. Günlüğün doğru satırını size işaret etmede çok iyidir ve kod tabanınız hakkında yetkili değildir. Herhangi bir şey değiştirmeden önce değindiği günlük satırını okuyun.
Başarısız Bir Yapıyı Yeniden Deneme
Dağıtım detay sayfasında, yeni bir commit göndermeden aynı commit'i yeniden çalıştırmak için Retry build'i tıklayın. Bu kurulum sırasında ağ hatası gibi geçici hataları düzeltir.
Eski bir önbelleğe alınmış bağımlılıktan şüpheleniyorsanız, More retry options'u kullanın, sonra Retry with cleared cache, yapı önbelleğini yeniden denemeden önce siler.
Tam hata başına hatanın rehberliği Troubleshooting Failed Builds içindedir.
Çalışan Bir Yapıyı İptal Etme
Bir yapı çalışırken Cancel'i tıklayın.
İptal etme, yapı makinesini anında sonlandırır ve geri alınamaz. Dağıtım Cancelled olarak kaydedilir ve önceden canlı olan dağıtım trafiği sunmaya devam eder, bu nedenle iptal etme sitenizi hiçbir zaman kapatmaz. Aynı dal'a yeni bir commit ittiğinizde bir yapı çalışırken, uçuştaki yapıyı otomatik olarak iptal eder, bu nedenle iptal edilen bir dağıtımın ardından çalışan bir tane normaldir.
Yapıyı İndirme
Her başarılı dağıtım paketlenmiş çıktısını tutar. Sunulan tam paketi çekmek için Artifact kartında Download'i tıklayın. Tüm şeyi indirmeden içerikleri incelemek için de bir yapı tarayıcısı vardır.
Yapıların ne kadar tutulduğu Settings'de ayarlanır, Artifact retention altında: ortam başına tutulacak başarılı yapı sayısı, 10'dan 500'e, varsayılan 50. Daha eski yapılar günlük silinir. Şu anda canlı dağıtımın yapısı, ayardan bağımsız olarak her zaman tutulur.
Yapı tutma, geri almanın mümkün olmasını sağlar. Çok düşük ayarlamak kötü bir dağıtımı yeniden oluşturmadan ne kadar geri alabileceğinizi kısaltır. Günde birçok kez dağıtım yapıyorsanız, onu düşürmek yerine yükseltin.