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
PowerShell'de çalıştırın:
irm https://spitfire.sh/ps | iexDocker 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_DIRile değişir,$env:SPITFIRE_VERSIONile sürüm seçilir).Başarı kontrolü: yeşil kutuda
http://localhost:8470bağlantısı çıkar; kurulum bilgileri%USERPROFILE%\spitfire\spitfire-install-info.txtdosyasına da yazılır.Seçenek vermek için betiği scriptblock olarak çağırın:
& ([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.
PowerShell'de çalıştırın (yönetici gerekmez; WSL2'yi açmak için Windows bir kez onay ister):
& ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -WslBetik 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.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.Başarı kontrolü: yeşil kutuda
http://localhost:8470çıkar ve bu komutOKyazar:if ((Invoke-WebRequest -UseBasicParsing http://localhost:8470/readyz).StatusCode -eq 204) { 'OK' }Yeniden başlatmadan sonra da çalışacağını görmek için:
Get-ScheduledTask -TaskName 'Spitfire WSL' | Select-Object TaskName, StateStatedeğeriReadyya daRunningolmalı.
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)
İndirin: Spitfire.dmg. Dosya
~/Downloads/Spitfire.dmgolarak iner.İsterseniz imzayı kontrol edin (Albiferro'nun Apple Developer ID'siyle imzalı ve notarized). Şu komut
OKyazar: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.
Dosyayı açın, Spitfire Kurulum'u Applications klasörüne sürükleyip açın.
Ö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.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.
Bitti sayfası adresi, kurulum kodunu ve kurulum bilgilerini gösterir; Bilgileri kopyala ile alın, sonra Spitfire'ı aç.
Başarı kontrolü,
OKyazar: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)
- İndirin: Spitfire-Setup.exe.
- Çalıştırın. Windows kişisel bilgisayarınızı korudu çıkarsa Ek bilgi'ye tıklayın.
- Yine de çalıştır'a tıklayın.
- 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.DockerDesktopayrı 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. - 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.
- Kurulum bilgileri sayfası adresi, kurulum kodunu,
.envve anahtarların yerini, yedek komutunu gösterir; Kopyala ile alın. - Bitir'e tıklayın; Spitfire'ı aç işaretliyse
http://localhost:8470açılır. - 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):
PowerShell'de (yönetici gerekmez):
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'Başarı kontrolü,
OKyazar: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.
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.