SpitfireYük Testi ve APMYenilikler

Windows ve macOS sihirbazları

Windows'ta Spitfire, Docker Desktop ya da WSL2 içindeki Docker Engine üzerinde çalışır; PowerShell'den tek komutla ya da setup.exe / .msi sihirbazıyla kurulur. macOS'ta terminal istemeyenler için .dmg sihirbazı var. Hepsi arkada aynı kurulum betiğini çalıştırır, sonuç Docker ile kurulum ile aynıdır. Docker Desktop Windows Server'da çalışmaz; orada Linux bir sanal makine kullanın, uzak runner ise Windows Server'da hizmet olarak çalışır.

Windows ile kurulum

  1. PowerShell'de çalıştırın:

    powershell
    irm https://spitfire.sh/ps | iex

    Docker Desktop yoksa kurmak (winget), kapalıysa başlatmak için izin ister; onay vermezseniz durur ve ne yapacağınızı yazar (Docker ya da Kubernetes yoksa). Paket %USERPROFILE%\spitfire'a açılır ($env:SPITFIRE_DIR ile değişir, $env:SPITFIRE_VERSION ile sürüm seçilir).

  2. Başarı kontrolü: yeşil kutuda http://localhost:8470 bağlantısı çıkar; kurulum bilgileri %USERPROFILE%\spitfire\spitfire-install-info.txt dosyasına da yazılır.

  3. Seçenek vermek için betiği scriptblock olarak çağırın:

    powershell
    & ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -Port 8480 -GrpcPort 8481 -Runners 4

install.ps1 seçenekleri install.sh ile aynıdır, PowerShell yazımıyla (--runners → -Runners): Kurulum seçenekleri. Yalnız Windows'a özgü olan -Wsl'dir (aşağıda). Docker'sız bir Windows sunucuya yalnız runner kuracaksanız Runner'lar → token penceresi → Windows sekmesindeki komutu kullanın: Runner'lar.

Docker Desktop olmadan: WSL2 içinde Docker Engine

Docker Desktop, 250'den fazla çalışanı ya da yıllık 10 milyon dolardan fazla geliri olan şirketlerde ücretli abonelik ister; Docker Engine Apache 2.0 lisanslı ve ücretsizdir. Spitfire'ı WSL2 içindeki bir Ubuntu-24.04'teki Docker Engine ile de çalıştırabilirsiniz. Docker yoksa betik Docker kurulu değil. Nasıl devam edelim? diye sorar; ikinci seçenek bu yoldur.

  1. PowerShell'de çalıştırın (yönetici gerekmez; WSL2'yi açmak için Windows bir kez onay ister):

    powershell
    & ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -Wsl

    Betik WSL2'yi açar (wsl --install --no-distribution), Ubuntu-24.04'ü kurar (varsa dosyalarına dokunmadan onu kullanır), içine download.docker.com'dan Docker Engine'i kurar, Spitfire'ı /opt/spitfire'a kurar ve oturum açılınca WSL2'yi ve Docker'ı başlatan Spitfire WSL zamanlanmış görevini ekler.

  2. WSL2 kuruldu; kullanılabilmesi için Windows'un yeniden başlatılması gerekiyor. yazarsa bilgisayarı yeniden başlatın ve 1. adımdaki komutu aynen tekrar çalıştırın; kaldığı yerden devam eder.

  3. Başarı kontrolü: yeşil kutuda http://localhost:8470 çıkar ve bu komut OK yazar:

    powershell
    if ((Invoke-WebRequest -UseBasicParsing http://localhost:8470/readyz).StatusCode -eq 204) { 'OK' }
  4. Yeniden başlatmadan sonra da çalışacağını görmek için:

    powershell
    Get-ScheduledTask -TaskName 'Spitfire WSL' | Select-Object TaskName, State

    State değeri Ready ya da Running olmalı.

Portlar WSL2'nin localhost yönlendirmesiyle Windows tarayıcısına gelir. Kurulum kendini deploy\docker\.wsl dosyasıyla işaretler; aynı komutla yapılan güncellemeler de WSL2 yolunu kullanır. setup.exe'de ön koşul sayfasındaki Docker Desktop olmadan (WSL2) aynı yolu açar (sessiz: Spitfire-Setup.exe /S /ENGINE=wsl); .msi yalnız Docker Desktop ile kurar. Spitfire'ı kaldır Spitfire'ı ve görevi siler, Ubuntu dağıtımı kalır; onu da silmek için wsl --unregister Ubuntu-24.04 (dağıtımdaki her şey gider).

macOS: kurulum sihirbazı (.dmg)

  1. İndirin: Spitfire.dmg. Dosya ~/Downloads/Spitfire.dmg olarak iner.

  2. İsterseniz imzayı kontrol edin (Albiferro'nun Apple Developer ID'siyle imzalı ve notarized). Şu komut OK yazar:

    bash
    spctl -a -t open --context context:primary-signature ~/Downloads/Spitfire.dmg 2>/dev/null && echo OK

    İlk açılışta macOS indirilen uygulamayı açmak isteyip istemediğinizi sorar; Aç'a basın. "Apple … doğrulayamadı" uyarısı eski bir dosya demektir, yeniden indirin.

  3. Dosyayı açın, Spitfire Kurulum'u Applications klasörüne sürükleyip açın.

  4. Ön kontroller sayfası hiçbir şey değiştirmez. Docker yoksa Docker'ı benim için kur → Evet, kur: Terminal'de brew install --cask docker çalışır (Mac şifrenizi isteyebilir) ve sihirbaz Docker Desktop'ı bekler; Homebrew yoksa indirme sayfası açılır. Docker kapalıysa Docker'ı başlat (3 dakikaya kadar bekler). Docker Desktop'ın sözleşmesini ilk açılışta siz kabul edersiniz.

  5. Tüm satırlar yeşil olunca İleri ile lisans, klasör, ayarlar ve ilk yönetici sayfalarını geçip Kur'a basın.

  6. Bitti sayfası adresi, kurulum kodunu ve kurulum bilgilerini gösterir; Bilgileri kopyala ile alın, sonra Spitfire'ı aç.

  7. Başarı kontrolü, OK yazar:

    bash
    curl -fsS http://localhost:8470/readyz && echo OK

Sihirbazı tekrar açınca mevcut kurulumu bulur ve Güncelle, Onar, Kaldır sunar. Kayıt: ~/Library/Logs/Spitfire Installer/.

Windows: kurulum sihirbazı (setup.exe / .msi)

  1. İndirin: Spitfire-Setup.exe.
  2. Çalıştırın. Windows kişisel bilgisayarınızı korudu çıkarsa Ek bilgi'ye tıklayın.
  3. Yine de çalıştır'a tıklayın.
  4. Dili seçin. İlk sayfa ön koşul denetimidir ve hiçbir şey değiştirmez. Docker yoksa Docker'ı benim için kur (winget install -e --id Docker.DockerDesktop ayrı pencerede çalışır; winget yoksa indirme sayfası açılır) ya da Docker Desktop olmadan (WSL2). Docker kapalıysa Docker'ı başlat, sonra Yeniden dene.
  5. Tüm satırlar tamam olunca İleri ile lisans, klasör, ayarlar (portlar, runner sayısı, demo, APM), ilk yönetici (isteğe bağlı) ve özetten geçip Kur'a basın.
  6. Kurulum bilgileri sayfası adresi, kurulum kodunu, .env ve anahtarların yerini, yedek komutunu gösterir; Kopyala ile alın.
  7. Bitir'e tıklayın; Spitfire'ı aç işaretliyse http://localhost:8470 açılır.
  8. Başarı kontrolü: Başlat menüsünde Spitfire, Spitfire'ı güncelle ve Spitfire'ı kaldır görünür; sayfa giriş ekranını gösterir.

Sessiz kurulum

.msi ile (Intune, GPO ya da betik):

  1. PowerShell'de (yönetici gerekmez):

    powershell
    irm https://spitfire.tr/download/Spitfire.msi -OutFile "$env:TEMP\Spitfire.msi"; Start-Process msiexec -Wait -ArgumentList '/i', "`"$env:TEMP\Spitfire.msi`"", '/qn', '/l*v', "`"$env:TEMP\spitfire-msi.log`"", 'PORT=8470', 'RUNNERS=2', 'LANG=tr'
  2. Başarı kontrolü, OK yazar:

    powershell
    if ((Invoke-WebRequest -UseBasicParsing http://localhost:8470/readyz).StatusCode -eq 204) { 'OK' }

setup.exe ile: Spitfire-Setup.exe /S /PORT=8470 /RUNNERS=2. Çıkış kodu 0 ise Spitfire /readyz'de yanıt vermiştir; kayıt %USERPROFILE%\spitfire\logs\setup-*.log. Boş bırakılan her ayar önceki kurulumun değerini korur.

MSI özelliği setup.exe anahtarı Anlamı
INSTALLFOLDER=C:\yol\ /D=C:\yol Kurulum klasörü (varsayılan %USERPROFILE%\spitfire; /D= en sonda yazılır)
PORT=8470 GRPCPORT=8471 /PORT=8470 /GRPCPORT=8471 Arayüz ve runner portları
RUNNERS=2 /RUNNERS=2 Yerel runner sayısı
ADMINEMAIL= ADMINPASSWORD= /ADMIN_EMAIL= /ADMIN_PASSWORD= İlk yönetici; boşsa kurulum kodu ile tarayıcıda oluşturulur
WITHDEMO=1 / 0 /DEMO=1 / 0 Demo uygulamayı kur / kurma
APM=1 / 0 /APM=1 / 0 APM'i aç / kapat
LANG=tr / en /LANG=tr / en Arayüz dili
- /ENGINE=wsl WSL2 içinde Docker Engine ile kur
STARTDOCKER=1 /STARTDOCKER=1 Docker Desktop kapalıysa başlat ve bekle (sessiz kurulum Docker'ı hiç kurmaz)
SKIPDOCKERCHECK=1 /SKIPDOCKERCHECK Docker denetimini atla (Docker'ı başka yoldan kurduysanız)
PURGE=1 (msiexec /x ile) /PURGE (uninstall-spitfire.exe /S ile) Kaldırırken verileri de sil

Docker yoksa ya da çalışmıyorsa setup.exe sessiz kurulumu dosya kopyalamadan 3 koduyla çıkar, nedeni %TEMP%\Spitfire-setup-precheck.log'dadır. .msi Docker'ı kurmaz; Docker Desktop yoksa dosya kopyalamadan durur ve İngilizce şunu yazar: Docker Desktop was not found; Spitfire runs on it and this setup does not install it. Install it: winget install -e --id Docker.DockerDesktop …. Docker'ı kurup açın ve .msi'yi yeniden çalıştırın.

Not

Sihirbaz ve .msi kod imzasız yayımlanıyor, SmartScreen uyarısı bu yüzden çıkar. Dosyayı Spitfire-Setup.exe.sha256 ile doğrulayabilirsiniz. Kurulum kullanıcı başınadır; Spitfire'ı kaldır verileri silmeden önce sorar, varsayılan olarak .env, yedekler ve loglar kalır.

Sık karşılaşılan sorunlar

Kurulumda bir adım hata verirse (Docker kapandı, imaj inmedi, port dolu…) sihirbaz ve .msi bir hata penceresi açar: HATA: ve Çözüm: satırları, hata kodu, logun son satırları ve log yolu. Kopyala hepsini alır, Log'u aç logu açar. Çözemezseniz hata kodunu ve log dosyasını support@spitfire.tr'ye gönderin.

Belirti: .msi yarıda kaldı, 1722 hatası verip geri alındı. Neden: Bir kurulum adımı hata verdi; .msi kendi mesajında nedeni yazamaz. İlk kurulum tamamen geri alınır (yarım konteynerler dahil), güncellemede mevcut kurulum korunur. Çözüm: 1722'den önce açılan Spitfire hata penceresini okuyun; kaçırdıysanız %TEMP%\Spitfire-setup-*.log'un son satırlarına bakın (kurulum klasörü silinse de bu kopya kalır). Ön koşulları & ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -Check ile kontrol edin.

İlgili sayfalar