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üğmesi
Tek tıkla güncelleme
Yalnız Docker kurulumlarında, varsayılan kapalı. Açmak için:
~/spitfire/install.sh docker --updater on # kapatmak için: --updater offSeç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
Süren bir koşu olmadığından emin olun (güncelleme controller'ı yeniden başlatır).
Controller sunucusunda kurulumdaki komutun aynısını çalıştırın (Docker ya da Kubernetes satırı):
curl -fsSL https://spitfire.sh | bash -s -- docker curl -fsSL https://spitfire.sh | bash -s -- kubernetes --context C --namespace NSWindows'ta:
irm https://spitfire.sh/ps | iex. Anahtarlar (deploy/docker/.envya daspitfire-secretsSecret'ı) ve veriler korunur; sürüm değişiyorsa veritabanı önce~/spitfire/backups/*.dumpolarak yedeklenir (son 5 tutulur;--no-backupatlar).Başarı kontrolü: yeşil kutu çıkar ve Lisans → Sürüm ve güncellemeler kartında yeni sürüm yazar.
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)
~/spitfire/install.sh docker --rollback # Kubernetes: install.sh kubernetes --rollbackWindows'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):
Yedek alın:
~/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.Başarı kontrolü, dosya listelenir:
ls -lh ~/spitfire-*.sfbak
Geri yüklemek için (bu ya da yeni bir makinede) önce Spitfire'ı kurun, sonra:
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).
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
~/spitfire/uninstall.sh docker
~/spitfire/uninstall.sh kubernetes --context C --namespace NS
~/spitfire/uninstall.sh runner # install.sh runner ile kurulan uzak runner'larWindows: & "$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.