Kurulum seçenekleri ve gereksinimler
Kurulum sayfası tek komutluk yolu anlatır; bu sayfa arkasındakileri: desteklenen sistemler, makine boyutu, Docker yoksa ne olduğu, bütün install.sh seçenekleri ve portlar. Baştan sona okumanız gerekmez, takıldığınız başlığa gidin.
Kurulum betiği ne yapar
install.sh (Windows'ta install.ps1) kurulum paketini spitfire.tr/download'dan indirip SHA-256'sını doğrular ve ~/spitfire'a açar; imaj Docker Hub'dan gelir (usespitfire/spitfire:<VERSION>, amd64 ve arm64). Postgres'i, controller'ı ve runner'ları başlatır. SPITFIRE_SECRET_KEY gibi gizli değerleri bir kez üretir ve sonraki her çalıştırmada korur; bu yüzden aynı komutu yeniden çalıştırmak güncellemedir.
Gereksinimler
| Kurulum | Gerekenler |
|---|---|
| Docker (Linux/macOS) | Docker Engine ya da Docker Desktop, Docker Compose v2, curl. Kullanıcı Docker daemon'una erişebilmeli (Linux'ta docker grubunda). |
| Kubernetes | Ek olarak kubectl ve aktif bir context. Node'lar imajı Docker Hub'dan çeker; erişim yoksa iç registry. |
| Windows | Docker Desktop, PowerShell 5.1 ya da 7, tar.exe (Windows 10 1803 ve sonrası ile gelir). |
İşletim sistemleri
| Ortam | Sürümler | Mimari |
|---|---|---|
| Linux (Docker Engine ve Compose v2) | Ubuntu 22.04 LTS ve sonrası; Debian 12 ve sonrası; RHEL, Rocky Linux, AlmaLinux 8 ve sonrası; Fedora (güncel sürümler) | amd64, arm64 |
| macOS (Docker Desktop) | macOS 14 Sonoma ve sonrası (Docker Desktop'ın desteklediği son üç sürüm) | Apple silicon, Intel |
| Windows (Docker Desktop, WSL 2) | Windows 11 23H2 ve sonrası; Windows 10 22H2 (64 bit) | x64 |
Kubernetes (kubectl ya da Helm 3) |
Kubernetes 1.28 ve sonrası (EKS, AKS, GKE, OpenShift, k3s, RKE2…) | amd64, arm64 node'lar |
| Uzak runner, Docker'sız Linux (systemd hizmeti) | Ubuntu 20.04 ve sonrası, Debian 11 ve sonrası, RHEL / Rocky / AlmaLinux 8 ve sonrası, SUSE Linux Enterprise 15 | amd64, arm64 |
| Uzak runner, Docker'sız Windows (Windows hizmeti) | Windows 10 / 11; Windows Server 2016, 2019, 2022, 2025 | x64 |
Docker Desktop Windows Server'da çalışmaz; orada Spitfire'ı bir Linux sanal makineye kurun, Windows Server'ı yalnız runner için kullanın.
Donanım
Tek makinede Postgres, controller ve runner'lar aynı makineyi paylaşır:
| Profil | Yük | Makine | Disk |
|---|---|---|---|
| Deneme | 500 VU'ya kadar, ~2.000 istek/sn | 2 vCPU, 4 GB RAM | 20 GB |
| Küçük ekip | 2.000 VU'ya kadar, ~10.000 istek/sn | 4 vCPU, 8 GB RAM | 40 GB SSD |
| Orta | 5.000 VU'ya kadar, ~25.000 istek/sn | 8 vCPU, 16 GB RAM | 80 GB SSD |
| Büyük | 10.000 VU'ya kadar, ~50.000 istek/sn | 16 vCPU, 32 GB RAM | 100 GB SSD |
Biz runner sayısını vCPU'nun yarısı kadar seçiyoruz (8 vCPU'da --runners 4). Kubernetes'te controller ile Postgres'e ~2 vCPU ayırın; varsayılan runner pod'u (2 vCPU / 1 GiB) yaklaşık 10.000 istek/sn ya da 3.000 VU taşır. Hesabın ayrıntısı: Runner'lar → Kapasite.
Betik kurmadan önce makinenin hangi profile uyduğunu ve neyi kuracağını yazar; Deneme profilinin altında uyarır ama durmaz. macOS ve Windows'ta Docker'ın kaynağı Docker Desktop → Settings → Resources'tan değişir.
Önce ön koşul kontrolü
Kontrol hiçbir şeyi değiştirmez; eksikleri ✗ ve bir Çözüm: satırıyla yazar.
Linux ya da macOS'ta terminalde:
curl -fsSL https://spitfire.sh | bash -s -- docker --checkWindows'ta PowerShell'de:
& ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -CheckKubernetes için
dockeryerinekubernetesyazın. Paket zaten kuruluysa~/spitfire/install.sh docker --check(Windows:& "$env:USERPROFILE\spitfire\install.ps1" docker -Check) de olur.Başarı kontrolü: son satır yeşil
✔ Ön koşullar tamam. Kurmak için: …olmalı ve komut 0 ile çıkar.EKSİK: N ön koşul karşılanmıyorgörürseniz herÇözüm:satırını uygulayıp 1. adımı tekrarlayın.
Docker ya da Kubernetes yoksa
Docker yoksa betik çalıştıracağı komutu yazar, sorar ve yalnız e derseniz kurar: Linux'ta get.docker.com ile (sudo gerekir; sizi docker grubuna ekler, grup oturumu yenileyince geçerli olur), macOS'ta brew install --cask docker, Windows'ta winget install -e --id Docker.DockerDesktop. Docker kapalıysa başlatmayı önerir ve 3 dakikaya kadar bekler. Docker Desktop'ın ilk açılıştaki sözleşmesini siz kabul edersiniz; Windows'ta WSL 2 için yeniden başlatma istenirse sonra komutu tekrarlayın. Docker Desktop, 250'den fazla çalışanı ya da 10 milyon dolardan fazla yıllık geliri olan şirketlerde ücretlidir; Windows'ta alternatif WSL2 içinde Docker Engine.
Kubernetes cluster'ı yoksa betik Sisteminizde erişilebilir bir Kubernetes cluster yok yazar ve Linux'ta tek düğümlü k3s kurmayı önerir (kubeconfig ~/.kube/config'e, o dosya varsa ~/.kube/spitfire-k3s.yaml'a yazılır; kaldırmak için sudo /usr/local/bin/k3s-uninstall.sh). Erişilemeyen ama tanımlı bir context varsa k3s önerilmez, hata yazılır.
Terminal yoksa (CI, --offline) soru sorulmaz ve --yes Docker'ı kurmaz. Sormadan yapması için seçeneği açıkça verin:
Linux'ta Docker yoksa kurmak için:
curl -fsSL https://spitfire.sh | bash -s -- docker --install-dockerDocker kurulu ama kapalıysa başlatmak için:
curl -fsSL https://spitfire.sh | bash -s -- docker --start-dockerLinux'ta Kubernetes yoksa k3s kurmak için:
curl -fsSL https://spitfire.sh | bash -s -- kubernetes --install-k3sWindows'ta (PowerShell):
& ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -InstallDocker -StartDockerKontrol: kurulum
Docker hazırsatırından sonra devam eder (Windows'taDocker Desktop çalışıyor, k3s içink3s cluster'ı hazır).docker info --format '{{.ServerVersion}}' && echo OK
Hatayı destek ekibine göndermek
Betik bir adımda durursa HATA: ve Çözüm: satırlarını, en altta da SF-{{version}}-L355 gibi bir hata kodu yazar (Windows'ta -W ile biter). Çözemezseniz hatayı destek ekibine göndermeyi önerir; onayınız olmadan hiçbir şey gitmez.
- Gidecek rapor ekranda gösterilir, ardından
Bu hatayı destek ekibine göndereyim mi? … [e/H]sorulur. Göndermek içineyazın. - E-posta adresi isteğe bağlıdır; boş geçebilirsiniz.
- Başarı kontrolü:
Rapor numaranız: IR-XXXXXX; support@spitfire.trsatırı çıkar; yazışmada bu numarayı verin.Rapor gönderilemedigörürseniz satırdaki dosyayı support@spitfire.tr adresine e-postayla gönderin.
Terminal yoksa (--yes, CI) hiçbir şey gönderilmez; betik sonradan göndermenin komutunu yazar:
~/spitfire/install.sh --send-report ~/spitfire/logs/spitfire-install-report-20261109-153000.jsonWindows'ta & "$env:USERPROFILE\spitfire\install.ps1" -SendReport <dosya>; e-posta için --report-email ad@ornek.com (-ReportEmail).
Rapor logs klasöründe, yalnız sizin okuyabildiğiniz bir JSON dosyasıdır ve gidecek her şey odur: sürüm, sistem, adım, hata kodu, mesaj ve log'un son 16 KB'ı. Parolalar, token'lar, lisans anahtarları ve kurulum kodu dosyaya yazılmadan [redacted] olur. Sihirbazlarda aynı raporu hata penceresindeki Hatayı gönder gönderir. Hiç sorulmasın istiyorsanız SPITFIRE_REPORT=off verin.
Deneme hedefi
Henüz test edeceğiniz bir sistem yoksa kurulumu --with-demo ile çalıştırın (Windows: -WithDemo; eski adı --demo da çalışır):
curl -fsSL https://spitfire.sh | bash -s -- docker --with-demoYanına yalnız yerel runner'ların ulaştığı küçük bir demo uygulama kurulur: bir HTTP API (/api/items, OCPP için /ocpp/{id}) ve bir demo mağaza (/store). Mağazanın araması bilerek 2 bağlantılık bir connection pool'da çalışır; saniyede 90 aramanın üstünde 503 döner. Yük Testi → Dashboard'daki ilk adımlar listesi hazır gelen "Demo mağaza: kırılma noktasını bul" testini başlatır; iki dakikadan kısa sürede kırıldığı yük ve yavaş adım rapora düşer. Testler → Şablondan'daki HTTP ve OCPP şablonları da bu adrese bağlıdır.
Ayar güncellemelerde korunur; kaldırmak için ~/spitfire/install.sh docker --no-demo. Kubernetes ve Helm kurulumunda demo uygulama yoktur. Kurmadan denemek için giriş sayfasındaki Demoyu aç salt okunur, her gece sıfırlanan ortak demoyu açar (kendi kurulumunuzda kapalıdır, SPITFIRE_DEMO_MODE).
Kurulum seçenekleri
~/spitfire/install.sh --help hepsini listeler; Windows'ta aynı adın PowerShell yazımı geçer (--runners → -Runners).
| Seçenek | Açıklama |
|---|---|
--port 8480 --grpc-port 8481 |
Docker: arayüz ve runner portları (varsayılan 8470/8471) |
--runners N |
Yerel runner sayısı (varsayılan 2) |
--location AD |
Yerel runner'ların lokasyonu (varsayılan local; a-z 0-9 - _ .) |
--with-demo / --no-demo |
Docker: demo uygulamayı kur / kaldır |
--updater on|off |
Docker: tek tıkla güncelleme (varsayılan kapalı) |
--install-docker, --start-docker, --install-k3s |
Docker'ı ya da k3s'i sormadan kur / başlat (ayrıntı) |
--otlp-grpc-port 4327 |
Docker: OTLP/gRPC portu (varsayılan 4317; doluysa boş bir port seçilir, arayüz gösterir) |
--tower on|off |
Docker: sunucu metrikleri için Tower ve Collector (varsayılan kapalı; --tower-port 4318) |
--grpc-public-addr HOST:PORT |
Uzak runner'ların bağlanacağı adres (Docker'da varsayılan LAN IP'si) |
--version V / --image IMAGE |
Başka bir sürüm / belirli bir imaj |
--offline DOSYA |
İnternetsiz paketten kur ya da güncelle (İnternetsiz güncelleme) |
--admin-email E --admin-password P |
İlk yöneticiyi kurulumda oluştur (parola en az 8 karakter) |
--no-backup |
Güncellemede veritabanı yedeğini alma |
--rollback [YEDEK] |
Son güncellemeyi geri al |
--support-bundle |
Kurmaz; destek paketi (zip) hazırlar |
-y, --yes |
Onay sorma |
SPITFIRE_DIR=/opt/spitfire |
Kurulum klasörü (varsayılan ~/spitfire) |
SPITFIRE_LANG=tr / en |
Betiğin ve arayüzün dili (varsayılan sistemin dili; güncellemede önceki kurulumunki) |
Değişkenler bash'in önüne yazılır, curl'ün önünde betiğe ulaşmaz: curl -fsSL https://spitfire.sh | SPITFIRE_LANG=tr bash -s -- docker.
Portlar ve ağ
| Port | Ne için | Kim erişmeli |
|---|---|---|
| 8470 (Docker; Kubernetes'te NodePort 30470) | Web arayüzü ve REST API | Kullanıcılar, CI hatları |
| 8471 | Uzak runner'ların bağlandığı gRPC endpoint'i, TLS | Başka lokasyonlardaki runner sunucuları (dışarıdan içeri TCP) |
| 4317 | OTLP/gRPC alıcısı (OTLP/HTTP 8470'te /otlp altında); SPITFIRE_OTLP_GRPC_TLS_CERT/_KEY verilirse TLS |
Trace, metrik ve log gönderen servisler ve Collector'lar |
| 8475 | Aynı makinedeki/cluster'daki runner'lar için düz gRPC | Yalnızca kurulumun kendi runner'ları; yayınlanmaz |
| 8472 (opsiyonel) | Mock servisler (SPITFIRE_MOCK_ADDR ile açılır) |
Test edilen sistem |
Runner'lar controller'a dışarı doğru bağlanır; runner sunucusunda gelen port açmanız gerekmez. Ağ ayarları:
| Değişken | Ne zaman |
|---|---|
SPITFIRE_PUBLIC_URL |
Bildirim ve e-posta bağlantılarındaki adres (ör. https://spitfire.sirket.com). Yönetim → Entegrasyonlar → Ayarlar → Genel'deki adres doluysa o geçerlidir. |
SPITFIRE_TRUSTED_PROXIES |
Önde genel adresli bir vekil varsa (bulut yük dengeleyici, Cloudflare) CIDR listesi. Yoksa audit log ve giriş sınırları vekilin adresini görür; X-Forwarded-For yalnız loopback ve özel ağdan okunur. |
SPITFIRE_TRUST_PRIVATE_NETWORKS=false |
Kullanıcılar özel ağdan vekilsiz geliyorsa; istemci adresini yalnız tanıttığınız vekiller belirler. |
SPITFIRE_SIGNIN_BURST |
Çok kullanıcı tek NAT arkasındaysa. Bir adres art arda 30 deneme yapar, sonra 2 sn'de bir; bu değişken 30'u artırır. Hesap başına sınır 10 yanlış parola, sonra dakikada bir. |
SPITFIRE_ALLOW_LINK_LOCAL=1 |
Test edilen sistem link-local bir adresteyse (runner'larda). |
SPITFIRE_EGRESS=public-only |
Yalnız internetteki hedefleri test eden paylaşımlı ortamlar; localhost ve özel adresler de kapanır. Şirket içi kurulumda gerekmez. |
Link-local ve bulut metadata adreslerine (169.254.0.0/16, fe80::/10, fd00:ec2::254, 100.100.100.200) ne controller ne test adımları gider; istek link-local and cloud metadata addresses are not allowed hatasıyla düşer. public-only kipinde hata this installation reaches only public internet addresses ekini taşır. Helm'de --set networkPolicy.egress=public-only ayrıca egress NetworkPolicy'leri kurar; isteğe bağlı runner'lar için networkPolicy.kubeAPICIDR, iç ağdaki veritabanı, SMTP ya da SSO için networkPolicy.controllerAllowCIDRs verin.
TLS ve runner pin temelleri
8471 her zaman TLS'tir. Controller kimliğini ilk açılışta üretir ve SPITFIRE_SECRET_KEY ile şifreli saklar; uzak runner onu pin'iyle (sha256:…) doğrular. Pin ve hazır komut Runner'lar sayfasındaki token penceresindedir. Kendi sertifikanız için SPITFIRE_GRPC_TLS_CERT ve SPITFIRE_GRPC_TLS_KEY verin; runner'lar o zaman --tls ya da --ca <PEM dosyası> kullanır. Ayrıntılar: Runner'lar → TLS pin ve sertifikalar.
Sık karşılaşılan sorunlar
En sık karşılaşılan durum: kullanıcı docker grubuna eklenmiş ama oturumu yenilenmemiş, betik daemon'a ulaşamıyor. Çıkış yapıp yeniden girmek yeter.
| Belirti | Neden | Çözüm |
|---|---|---|
HATA: Docker Compose bulunamadı. |
Compose v2 eklentisi kurulu değil. | Eklentiyi kurun: https://docs.docker.com/compose/install/ |
HATA: İmaj indirilemedi: usespitfire/spitfire:... |
Makine Docker Hub'a çıkamıyor ya da sürüm yanlış. | docker pull ile erişimi deneyin; proxy arkasındaysanız Docker daemon'unun proxy ayarını yapın (Proxy arkasında kurulum); sürümü kontrol edin. |
| Kurulum ekranı yerine giriş sayfası açılıyor: "Kurulum zaten tamamlanmış". | İlk yönetici zaten var (belki --admin-email ile). |
O hesapla girin; parolası bilinmiyorsa sunucuda spitfire-controller reset-password: Kullanıcılar ve erişim. |
HATA: Controller 180 sn içinde hazır olmadı. |
Controller başlarken hata verdi (veritabanı, eksik ayar…). | docker compose -p spitfire -f ~/spitfire/deploy/docker/docker-compose.yml logs -f controller ile logu okuyun; çözemezseniz ~/spitfire/install.sh --support-bundle ile destek paketi hazırlayın (Sorun giderme). |