SpitfireYük Testi ve APMYenilikler

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.

  1. Linux ya da macOS'ta terminalde:

    bash
    curl -fsSL https://spitfire.sh | bash -s -- docker --check

    Windows'ta PowerShell'de:

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

    Kubernetes için docker yerine kubernetes yazın. Paket zaten kuruluysa ~/spitfire/install.sh docker --check (Windows: & "$env:USERPROFILE\spitfire\install.ps1" docker -Check) de olur.

  2. 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ıyor gö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:

  1. Linux'ta Docker yoksa kurmak için:

    bash
    curl -fsSL https://spitfire.sh | bash -s -- docker --install-docker
  2. Docker kurulu ama kapalıysa başlatmak için:

    bash
    curl -fsSL https://spitfire.sh | bash -s -- docker --start-docker
  3. Linux'ta Kubernetes yoksa k3s kurmak için:

    bash
    curl -fsSL https://spitfire.sh | bash -s -- kubernetes --install-k3s
  4. Windows'ta (PowerShell):

    powershell
    & ([scriptblock]::Create((irm https://spitfire.sh/ps))) docker -InstallDocker -StartDocker
  5. Kontrol: kurulum Docker hazır satırından sonra devam eder (Windows'ta Docker Desktop çalışıyor, k3s için k3s cluster'ı hazır).

    bash
    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.

  1. Gidecek rapor ekranda gösterilir, ardından Bu hatayı destek ekibine göndereyim mi? … [e/H] sorulur. Göndermek için e yazın.
  2. E-posta adresi isteğe bağlıdır; boş geçebilirsiniz.
  3. Başarı kontrolü: Rapor numaranız: IR-XXXXXX; support@spitfire.tr satırı çıkar; yazışmada bu numarayı verin. Rapor gönderilemedi gö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:

bash
~/spitfire/install.sh --send-report ~/spitfire/logs/spitfire-install-report-20261109-153000.json

Windows'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):

bash
curl -fsSL https://spitfire.sh | bash -s -- docker --with-demo

Yanı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).

İlgili sayfalar