SpitfireYük Testi ve APMYenilikler

Kubernetes'e kurulum

Kubernetes'te Spitfire bir namespace'e controller, Postgres ve runner pod'ları olarak kurulur; kubectl ile ya da Helm chart'ıyla. Yük büyüdükçe runner pod sayısını artırmak tek satırdır, bu yüzden 5.000 VU'nun üstündeki işlerde biz bu yolu öneriyoruz. Tek makinede deneme için Docker ile kurulum daha kısadır. Demo uygulama (--with-demo) Kubernetes'te yoktur.

Kubernetes ile kurulum

  1. Doğru cluster'da olduğunuzu kontrol edin:

    bash
    kubectl config current-context
  2. Ön koşulları kontrol edin (hiçbir şey değiştirmez):

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

    Son satır ✔ Ön koşullar tamam olmalı. Sisteminizde erişilebilir bir Kubernetes cluster yok görürseniz bir cluster hazırlayın (tek Linux makinede curl -sfL https://get.k3s.io | sh -, macOS/Windows'ta Docker Desktop → Settings → Kubernetes → Enable ya da kind create cluster) ve kontrolü tekrarlayın.

  3. Kurun (varsayılan namespace spitfire, context aktif olan; değiştirmek için --namespace NS, --context C):

    bash
    curl -fsSL https://spitfire.sh | bash -s -- kubernetes
  4. Başarı kontrolü: pod'lar 3 dakika içinde Running ve 1/1 olur.

    bash
    kubectl -n spitfire get pods
  5. Kurulum kodunu çıktıdan kopyalayıp adresi açın. Arayüz NodePort 30470'tedir; bu makineden NodePort'a ulaşılamıyorsa kurulum arka planda kubectl port-forward başlatır (deploy/kubernetes/.port-forward.pid).

Pod'lar root olmadan, salt okunur kök dosya sistemiyle, capabilities olmadan ve RuntimeDefault seccomp ile çalışır. NetworkPolicy'ler (CNI destekliyorsa) Postgres'e yalnız controller'ın, düz metin runner portuna (8475) yalnız bu kurulumun runner'larının erişmesine izin verir. Controller kapanırken aktif koşuları durdurup sonuçlarını kaydeder (30 sn'ye kadar; pod'a 45 sn tanınır).

Seçenek Açıklama
--namespace NS, --context C Hedef (varsayılan spitfire, current-context)
--service-type T, --node-port N NodePort (varsayılan, 30470), LoadBalancer, ClusterIP
--storage-class SC, --storage-size S Postgres PVC'si (varsayılan cluster default, 5Gi)
--local-port N port-forward yedeği için yerel port
--runners N Sürekli açık runner sayısı
--on-demand-runners N Koşu sırasında pod olarak açılan runner'lar (Runner'lar)
--build --registry REG Yalnız kaynak ağacında: imajı derleyip registry'nize push eder (kind, minikube, k3d, Docker Desktop'ta --registry gerekmez). İndirilen pakette kaynak kod yoktur.

Helm ile

Helm, Argo CD ya da Flux ile yönetilen cluster'lar için chart aynı parçaları aynı güvenlik ayarları ve adlarla (spitfire-controller, spitfire-secrets…) kurar.

  1. Ön kontrol; komutlar hatasız dönmeli, ikincisi yes yazmalı:

    bash
    kubectl cluster-info
    kubectl auth can-i create namespaces
    helm version --short

    İlki hata verirse cluster yoktur (yukarıdaki 2. adım). İkincisi no yazarsa yöneticinizden bir namespace isteyin ve aşağıda --create-namespace yerine -n <o-namespace> kullanın.

  2. Kurun:

    bash
    helm repo add spitfire https://spitfire.sh/helm
    helm install spitfire spitfire/spitfire -n spitfire --create-namespace
  3. Başarı kontrolü: kubectl -n spitfire get pods -w ile pod'ların 3 dakika içinde Running ve 1/1 olmasını bekleyin. Pending kalan pod için kubectl -n spitfire describe pod <ad>; çoğunlukla varsayılan StorageClass yoktur (kubectl get storageclass, sonra --set postgres.storage.storageClass=<ad>).

https://spitfire.sh/helm, https://spitfire.tr/download/helm'in kısa hâlidir; proxy ya da firewall arkasında spitfire.tr'ye izin verin. Kurulum notları arayüzün nasıl açılacağını ve kurulum kodunun nasıl okunacağını yazar.

Değer Anlamı
controller.service.type ClusterIP (varsayılan; ingress ya da port-forward ile), NodePort, LoadBalancer
ingress.enabled, ingress.host, ingress.className, ingress.tls Arayüz ingress controller'ınızın arkasında
controller.grpcPublicAddr Başka lokasyondaki runner'ların bağlandığı host:8471
runners.replicas, runners.location Sürekli açık runner'lar (varsayılan 2, local)
onDemandRunners.max Koşu sırasında pod olarak açılan runner'lar (0: kapalı)
postgres.enabled, externalDatabase.existingSecret Cluster içinde Postgres ya da kendi veritabanınız (DSN'li bir Secret)
secrets.existingSecret Kurulumun anahtarlarını kendiniz verin
admin.email, admin.password, license.key İlk yönetici ve lisans anahtarı (isteğe bağlı)
proxy.httpsProxy, proxy.noProxy Controller'ın çıkış proxy'si

Anahtarlar ilk kurulumda üretilir, her yükseltmede korunur ve helm uninstall ile silinmez; veritabanı diski de kalır. spitfire-secrets Secret'ını yedekleyin. Güncelleme (kart da bu komutu gösterir): helm repo update spitfire && helm upgrade spitfire spitfire/spitfire -n spitfire --reuse-values.

Sık karşılaşılan sorunlar

Belirti: Sisteminizde erişilebilir bir Kubernetes cluster yok. Neden: kubectl'de etkin bir context yok ya da cluster yanıt vermiyor. Çözüm: kubectl config get-contexts ve kubectl cluster-info ile kontrol edin; cluster yoksa 2. adımdaki yollardan biriyle hazırlayın. Tek makine için Docker ile kurulum daha basittir.

İlgili sayfalar