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
Doğru cluster'da olduğunuzu kontrol edin:
kubectl config current-contextÖn koşulları kontrol edin (hiçbir şey değiştirmez):
curl -fsSL https://spitfire.sh | bash -s -- kubernetes --checkSon satır
✔ Ön koşullar tamamolmalı.Sisteminizde erişilebilir bir Kubernetes cluster yokgörürseniz bir cluster hazırlayın (tek Linux makinedecurl -sfL https://get.k3s.io | sh -, macOS/Windows'ta Docker Desktop → Settings → Kubernetes → Enable ya dakind create cluster) ve kontrolü tekrarlayın.Kurun (varsayılan namespace
spitfire, context aktif olan; değiştirmek için--namespace NS,--context C):curl -fsSL https://spitfire.sh | bash -s -- kubernetesBaşarı kontrolü: pod'lar 3 dakika içinde
Runningve1/1olur.kubectl -n spitfire get podsKurulum 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-forwardbaş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.
Ön kontrol; komutlar hatasız dönmeli, ikincisi
yesyazmalı:kubectl cluster-info kubectl auth can-i create namespaces helm version --shortİlki hata verirse cluster yoktur (yukarıdaki 2. adım). İkincisi
noyazarsa yöneticinizden bir namespace isteyin ve aşağıda--create-namespaceyerine-n <o-namespace>kullanın.Kurun:
helm repo add spitfire https://spitfire.sh/helm helm install spitfire spitfire/spitfire -n spitfire --create-namespaceBaşarı kontrolü:
kubectl -n spitfire get pods -wile pod'ların 3 dakika içindeRunningve1/1olmasını bekleyin.Pendingkalan pod içinkubectl -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.