SpitfireYük Testi ve APMYenilikler

Güncelleme ve yedekleme

Spitfire'ı güncellemek, kurulum komutunu yeniden çalıştırmaktır: betik önce veritabanını yedekler, sonra yeni imajı çeker; bir şey ters giderse --rollback ile dönersiniz. En sık karşılaşılan kayıp şu: sunucu yeniden kurulurken .env yedeklenmemiş, testler yerinde ama kayıtlı bağlantıların parolaları artık açılmıyor. Bu yüzden yedekleme bölümünü güncellemeden önce okuyun.

Güncelleme

Yeni sürümü nasıl fark edersiniz

Controller saatte bir spitfire.tr'ye yeni sürüm olup olmadığını sorar (yalnız kendi sürümünü gönderir). Yeni sürüm varsa admin'ler her sayfanın üstünde Spitfire X çıktı bandını görür. Nasıl güncellenir? bu kuruluma uygun komutu (Docker, Windows, Kubernetes, uzak runner) kopyala düğmesiyle açar; Bu sürüm için gizle bandı kapatır, kırmızı Güvenlik güncellemesi bandı ise gizlenmez.

Lisans → Sürüm ve güncellemeler kartı kurulu sürümü, kurulum türünü, son kontrolün sonucunu, Çıkış proxy'si'ni ve güncelleme yolunu gösterir; Şimdi kontrol et beklemeden kontrol eder.

Lisans sayfasındaki Sürüm ve güncellemeler kartı: kurulu sürüm, kurulum türü, güncelleme kontrolü ve Şimdi kontrol et düğmesiLisans sayfasındaki Sürüm ve güncellemeler kartı: kurulu sürüm, kurulum türü, güncelleme kontrolü ve Şimdi kontrol et düğmesi

Tek tıkla güncelleme

Yalnız Docker kurulumlarında, varsayılan kapalı. Açmak için:

bash
~/spitfire/install.sh docker --updater on        # kapatmak için: --updater off

Seçim deploy/docker/.env içinde SPITFIRE_UPDATER olarak saklanır. Açıkken yeni sürüm çıkınca bantta ve kartta Şimdi güncelle görünür (yalnız admin'ler; her istek audit log'a yazılır).

  • Docker socket'ine yalnız ayrı, küçük bir updater konteyneri erişir (compose profili updater); controller erişmez. Socket host'ta root yetkisi demektir, özellik bu yüzden siz açmadıkça kapalıdır.
  • Updater yalnız imzalı sürüm listesindeki (releases.json + imza) daha yeni bir sürüme geçer.
  • Süren koşuların bitmesini bekler ("N koşunun bitmesi bekleniyor"), bu arada yeni koşu başlamaz; Vazgeç iptal eder.
  • Paketi indirip SHA-256'sını doğrular ve install.sh docker --yes çalıştırır: veritabanı backups/'a yedeklenir, imajlar çekilir, controller birkaç dakika kapalı kalıp yeniden başlar.
  • Hata olursa arayüz hatayı, yedeğin yolunu ve ~/spitfire/install.sh docker --rollback <yedek> komutunu gösterir; çıktı updates/ klasöründedir.

Kubernetes/Helm, Windows, uzak Docker daemon'ı (DOCKER_HOST=tcp://…) ve --offline kurulumlarda bu düğme yoktur; kart güncellemeyi numaralı adımlarla anlatır.

Otomatik güncelleme

Tek tıkla güncelleme açıksa kartta Yeni sürüm çıkınca otomatik güncelle anahtarı görünür (varsayılan kapalı, yalnız kurulum admin'leri). Açıkken yeni sürüm onay sorulmadan, yukarıdaki adımların aynısıyla kurulur. Başarısız ya da iptal edilen sürüm tekrar denenmez; onu Şimdi güncelle ile başlatırsınız. Her otomatik güncelleme audit log'a spitfire-auto-update olarak yazılır.

Adım adım güncelleme

  1. Süren bir koşu olmadığından emin olun (güncelleme controller'ı yeniden başlatır).

  2. Controller sunucusunda kurulumdaki komutun aynısını çalıştırın (Docker ya da Kubernetes satırı):

    bash
    curl -fsSL https://spitfire.sh | bash -s -- docker
    curl -fsSL https://spitfire.sh | bash -s -- kubernetes --context C --namespace NS

    Windows'ta: irm https://spitfire.sh/ps | iex. Anahtarlar (deploy/docker/.env ya da spitfire-secrets Secret'ı) ve veriler korunur; sürüm değişiyorsa veritabanı önce ~/spitfire/backups/*.dump olarak yedeklenir (son 5 tutulur; --no-backup atlar).

  3. Başarı kontrolü: yeşil kutu çıkar ve Lisans → Sürüm ve güncellemeler kartında yeni sürüm yazar.

  4. Başka lokasyonlardaki runner'ları da güncelleyin: Runner'lar → Runner güncelleme. Runner'lar sayfası farklı sürümdeki runner'ları sarı eski sürüm etiketiyle işaretler.

Geri alma (rollback)

bash
~/spitfire/install.sh docker --rollback          # Kubernetes: install.sh kubernetes --rollback

Windows'ta & "$env:USERPROFILE\spitfire\install.ps1" -Rollback. Betik şimdiki veritabanını yedekler, backups/ altındaki en yeni yedeği (ya da --rollback backups/<dosya>.dump) geri yükler ve o yedeği alan sürüme döner. Yedekten sonraki değişiklikler gelmez. Terminalsiz çalışırken --yes gerekir.

Yedekleme ve SPITFIRE_SECRET_KEY

Veriler Postgres'tedir, bağlantı secret'ları ise SPITFIRE_SECRET_KEY ile şifrelenir; ikisini birlikte yedekleyin. Biz tek dosyalık yedeği öneriyoruz (veritabanı ve anahtarlar, seçtiğiniz parolayla şifreli):

  1. Yedek alın:

    bash
    ~/spitfire/install.sh docker --backup ~/spitfire-$(date +%F).sfbak        # Kubernetes: ~/spitfire/install.sh kubernetes --backup …

    Parola sorulur (en az 12 karakter; zamanlanmış iş için SPITFIRE_BACKUP_PASSPHRASE). Parolayı dosyadan ayrı saklayın, parolasız yedek açılmaz.

  2. Başarı kontrolü, dosya listelenir:

    bash
    ls -lh ~/spitfire-*.sfbak

Geri yüklemek için (bu ya da yeni bir makinede) önce Spitfire'ı kurun, sonra:

bash
ls -lh ~/spitfire-*.sfbak
~/spitfire/install.sh docker --restore ~/spitfire-2026-10-10.sfbak

Şimdiki veritabanı önce backups/'a yedeklenir, sonra yedeğin verisi ve anahtarları yerine geçer; yedekteki kullanıcılarla giriş yapın. Daha yeni bir sürümün yedeği eski kuruluma yüklenmez (önce güncelleyin); hedef kurulum kendi Postgres parolasını korur.

Elle yedek için iki şey yeter: anahtarlar (Docker'da ~/spitfire/deploy/docker/.env, Kubernetes'te spitfire-secrets Secret'ı; parola kasasına kopyalayın) ve veritabanı (~/spitfire/backups/*.dump, pg_restore ile açılır; bu klasörü ya da Postgres volume'ünü kendi yedek sisteminize ekleyin).

Dikkat

SPITFIRE_SECRET_KEY kaybolursa kayıtlı bağlantı secret'ları (veritabanı, Kafka… parolaları) okunamaz, hepsini yeniden girersiniz. Controller'ın runner'lara gösterdiği TLS kimliği de bu anahtarla şifrelidir.

Kaldırma

bash
~/spitfire/uninstall.sh docker
~/spitfire/uninstall.sh kubernetes --context C --namespace NS
~/spitfire/uninstall.sh runner          # install.sh runner ile kurulan uzak runner'lar

Windows: & "$env:USERPROFILE\spitfire\uninstall.ps1" docker ya da & "$env:USERPROFILE\spitfire\uninstall.ps1" runner.

Varsayılan olarak veriler (Postgres volume'ü / PVC) ve anahtarlar (.env / spitfire-secrets) korunur; install.sh her şeyi geri getirir. --purge (Windows: -Purge) veritabanını, SPITFIRE_SECRET_KEY'i ve kurulum klasörünü (logs/ ve backups/ dahil) siler, geri alınamaz; saklamak istediğiniz yedeği önce dışarı kopyalayın. Klasörde başka bir kurulum duruyorsa ya da klasör bir kaynak kod kopyasıysa klasör bırakılır; --keep-files (-KeepFiles) da bırakır. Sihirbazla kurduklarınız ve runner, Tower, Collector, OTel agent'ı gibi diğer parçalar: Kurduklarınızı kaldırma.

Sık karşılaşılan sorunlar

Belirti: Yeniden kurulumdan sonra kayıtlı bağlantılar çalışmıyor; secret'lar okunamıyor ya da Test başarısız oluyor. Neden: SPITFIRE_SECRET_KEY değişmiş (ör. .env silinip yeniden kurulmuş). Çözüm: Yedeklediğiniz .env'i geri koyup kurulumu yeniden çalıştırın; yedek yoksa secret'ları yeniden girin.

İlgili sayfalar