· kaynak Hacker News – Front Page (native)
FailTrace, başarısız bir GitHub Actions çalışmasının URL'sini yerel bir yeniden üretime dönüştürüyor
FailTrace, başarısız bir GitHub Actions çalışmasının URL'sini alıyor, başarısız işi ve adımı tespit ediyor, hatayı sınıflandırıyor ve yerel bir Docker yeniden üretimini planlayıp çalıştırabiliyor.
Hatayla başlayan bir araç
Kırmızıya dönmüş bir GitHub Actions çalışmasını hata ayıklamak genellikle bir tarayıcı sekmesi, uzun bir log ve bolca kaydırma demektir. GitHub'da Ri4dH tarafından yayınlanan ve şu anda Hacker News ana sayfasında yer alan açık kaynak komut satırı aracı FailTrace farklı bir başlangıç noktası seçiyor: başarısız bir çalışmanın URL'sini yapıştırıyorsunuz ve araç geriye doğru çalışıyor.
Projenin README'sine göre araç, başarısız olan işi ve adımı buluyor, bunları çalışmanın gerçekleştiği tam commit'teki haliyle workflow dosyasıyla eşleştiriyor, hatayı log'lardan çıkarıyor ve sizinle hatayı kendi makinenizde yeniden üretmeniz arasındaki engelleri raporluyor.
Üç komut, tek URL
Her şey çalışma URL'siyle yönlendiriliyor ve üç fiil etrafında düzenleniyor. failtrace inspect bir çalışmanın neden başarısız olduğunu açıklıyor. failtrace plan başarısız işin yerel olarak nasıl yeniden üretilebileceğini hesaplıyor ve hiçbir şey çalıştırmadan planı yazdırıyor. failtrace repro yeniden üretimi Docker içinde gerçekleştiriyor.
Proje kendini henüz geliştirmenin erken aşamasında olarak tanımlıyor: üç komut da çalışıyor, ancak yeniden üretim şu anda yalnızca başarısız adımı düz bir run: script'i olan Linux işlerini kapsıyor. Marketplace action'larını çağıran adımlar yeniden oynatılmıyor.
inspect ne raporluyor
Inspect, triyaj katmanı. Her başarısız iş için çalışma bağlamını — workflow, event, branch, commit ve attempt — raporluyor, işi workflow dosyasındaki tanımına geri eşliyor, şablonlu isimlere sahip işler için matrix değerlerini yeniden oluşturuyor ve hem istenen runner etiketini hem de fiili runner imajını ve sürümünü tespit ediyor.
Başarısız adım, tanımıyla ve log'da yazdırıldığı haliyle komutuyla, ifadeleri çözülmüş şekilde gösteriliyor. Bunun ardından bir teşhis katmanı, exit kodunu, hata açıklamalarını ve çok çeşitli ekosistemlerden — Go, pytest, Jest, Vitest, Cargo ve RSpec — başarısız test isimlerini birleştiriyor ve hataya bir kategori atıyor: test, build, bağımlılık, lint, generated-diff, timeout veya out-of-memory.
README'deki somut örnek, log'u yüzlerce satırlık go.sum diff'iyle sonlanan başarısız bir prometheus/prometheus çalışmasını kullanıyor. FailTrace alıntıyı ilk hata satırına göre konumlandırıyor; böylece asıl neden — go mod tidy'nin go.mod'u değiştirmesi — sondaki gürültünün altında gömülü kalmak yerine görünür oluyor. Teşhis şöyle dosya güncel değil, exit kodu 2.
Inspect ayrıca yerel yeniden üretimi zorlaştıran her şeyi ortaya çıkarıyor: service container'lar, job container'lar, adımın kullandığı secret'lar, yeniden kullanılabilir workflow'lar ve macOS ya da Windows runner'lar. Kenar durumlar sessizce başarısız olmak yerine açıklanıyor; buna hiçbir iş başlamadan önce başarısız olan çalışmalar, depoda dosyası olmayan dinamik workflow'lar ve süresi dolmuş log'lar da dahil.
Çalıştırmadan önce planlayın
failtrace plan hiçbir şey çalıştırmadan duruyor. Başarısız bir pytest-dev/pytest işi için örnek çıktı yaklaşımı gösteriyor: runner imajına uygun bir Ubuntu imajı seçiyor, gevşek bir "3.11" belirtiminin arkasındaki kesin Python sürümünü çözüyor, bir composite action'ı adımlarına açıyor, başka bir işten yapılacak artifact indirmelerinin atlandığını belirtiyor ve CI'da başarısız olan adımı işaretliyor. Bu örnekteki karar "PARTIAL" — plan çalışabilir, ancak uyarılar CI'dan farklı davranabileceği anlamına geliyor. Yol haritasında ise yeniden üretildi, üretilmedi ya da flaky şeklinde kesin kararlar ve CI ile yerel makine arasındaki farkların bir raporu yer alıyor.
act ile ilişkisi
En açık karşılaştırma, workflow dosyasından workflow'ları yerel olarak çalıştıran act. FailTrace ikisini rakip değil tamamlayıcı olarak konumlandırıyor. Act, sizin yapılandırdığınız bir workflow'un tamamını çalıştırır; FailTrace ise belirli bir hatadan başlar — bilinen bir commit, attempt, iş, matrix kombinasyonu ve adım — ve yalnızca başarısız adımın ihtiyaç duyduğu şeyi yeniden oynatmayı hedefler.
Kurulum ve kimlik doğrulama
Araç; macOS, Linux ve Windows için amd64 ve arm64 olarak önceden derlenmiş binary'ler, SHA-256 sağlama toplamını doğrulayan macOS ve Linux için bir kurulum script'i ve Go 1.24 veya daha yeni bir sürüm çalıştıranlar için go install olarak dağıtılıyor.
Log API'si token talep ettiği için herkese açık depularda bile bir GitHub token gerekiyor. FailTrace önce GITHUB_TOKEN, sonra GH_TOKEN, ardından GitHub CLI'dan gh auth token kontrol ediyor. Özel depular için Actions okuma erişimi olan bir token gerekir ve GitHub Enterprise Server kurulumları destekleniyor.
Neden önemli
CI hataları çoğu ekip için hâlâ tarayıcıda log okuyarak hata ayıklanıyor — ve flaky ya da ortama özgü hatalar en kötü durumlar, çünkü kanıt dağınık ve bazen süresi dolmuş oluyor. Bir çalışma URL'sini sınıflandırılmış bir teşhise, bir yeniden üretim planına ve nihayetinde yerel bir yeniden oynatmaya dönüştüren araç bu iş akışına doğrudan saldırıyor. Tüm workflow yerine hatadan başlamak gerçekten farklı bir model ve mevcut erken halinde bile inspect ve plan komutları tek başına CI triyajından ciddi zaman kazandırabilecek görünüyor.
- #github-actions
- #ci-cd
- #open-source
- #developer-tools
- #docker