İnternetsiz ve kısıtlı ağ
Bankalarda ve kamu kurumlarında test ortamı çoğu zaman internete çıkmaz. Üç yol var: geçici internet erişimi, iç registry aynası (Harbor, Artifactory, Nexus) ya da tek dosyalık internetsiz paket. Biz iç registry aynasını öneriyoruz, çünkü sonraki güncellemeler de aynı yoldan gelir. Proxy arkasındaki kurulum da bu sayfada.
Her yolun sonunda kontrol aynıdır: curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8470/healthz 204 yazar.
İnternetsiz güncelleme
İnternete çıkmayan controller yeni sürümü kendisi öğrenemez. Güncelleme kontrolü kapalıysa (SPITFIRE_UPDATE_CHECK=off) ya da son kontrol başarısızsa ve kurulu sürüm 60 günden eskiyse, admin'ler sayfanın üstünde Bu sürüm N günlük notunu görür; kurulu sürümün tarihi Lisans → Sürüm ve güncellemeler kartında da yazar. Komutlardaki {{version}} bu yardımın geldiği sürümdür; daha yenisini indirdiyseniz onu yazın.
a) Geçici internet erişimi
- Güncelleme süresince controller sunucusuna (Kubernetes'te node'lara da) HTTPS (443) çıkışı açın:
spitfire.sh,spitfire.tr: kurulum betiği, paketler,releases.json, Helm chart'ı- Docker Hub:
registry-1.docker.io,auth.docker.io,production.cloudflare.docker.com,docker-images-prod.6aa30f8b08e16409b46e0173d6de2f56.r2.cloudflarestorage.com(imaj katmanları),hub.docker.com(Kubernetes kurulumunda sürüm kontrolü)
- Lisans → Sürüm ve güncellemeler kartında Şimdi kontrol et'e basın; yeni sürüm ve notları görünür. Kontrol kapalıysa bu adımı atlayın.
- Kartta gösterilen güncelleme komutunu çalıştırın (Adım adım güncelleme); veritabanı önce yedeklenir. Proxy üzerinden çıkıyorsanız komutu
HTTPS_PROXYtanımlıyken çalıştırın (Proxy arkasında kurulum). - Erişimi yeniden kapatın.
b) İç registry aynası (Harbor, Artifactory, Nexus)
İnternete çıkabilen bir makinede imajı çekip iç registry'nize gönderin (ya da registry'nizin Docker Hub proxy cache'ini kullanın):
docker pull usespitfire/spitfire:{{version}} docker tag usespitfire/spitfire:{{version}} harbor.ornek.local/spitfire/spitfire:{{version}} docker push harbor.ornek.local/spitfire/spitfire:{{version}}Kurulum paketini (
spitfire-{{version}}.tar.gz, spitfire.tr/kurulum'da listelenir) controller sunucusunda açıp bu imajla kurun (Docker ya da Kubernetes satırını seçin):tar -xzf spitfire-{{version}}.tar.gz -C ~/spitfire ~/spitfire/install.sh docker --image harbor.ornek.local/spitfire/spitfire:{{version}} ~/spitfire/install.sh kubernetes --image harbor.ornek.local/spitfire/spitfire:{{version}}
Helm'de: helm upgrade spitfire ./spitfire-{{version}}.tgz -n spitfire --reuse-values --set image.repository=harbor.ornek.local/spitfire/spitfire --set image.tag={{version}}. Yeni kurulumda postgres:16 da aynada olmalı: aynı şekilde gönderip --postgres-image harbor.ornek.local/spitfire/postgres:16 verin (Helm'de --set postgres.image=…); verilen imaj sonraki çalıştırmalarda korunur.
c) İnternetsiz kurulum paketi (--offline)
Her sürümle platform başına bir paket çıkar: spitfire-offline-<sürüm>-linux-amd64.tar.gz ve …-linux-arm64.tar.gz (spitfire.tr/kurulum'da .sha256 değerleriyle). İçinde Spitfire ve postgres:16 imajları (docker save), kurulum paketi, Helm chart'ı, imzalı releases.json ve imzalı SHA256SUMS vardır. İlk kurulum da yalnız bu paketle yapılır.
Paketi internete çıkan bir makinede indirip kurumunuzun yoluyla (onaylı USB, dosya aktarma sunucusu, atlama sunucusundan
scp) controller sunucusuna kopyalayın. Diskte paketin üç katı boş yer olsun.İlk kurulumda paketteki kurulum dosyalarını açın (güncellemede bu adım yok):
mkdir -p ~/spitfire && tar -xzf spitfire-offline-{{version}}-linux-amd64.tar.gz -C ~/spitfire spitfire-{{version}}.tar.gz tar -xzf ~/spitfire/spitfire-{{version}}.tar.gz -C ~/spitfire && rm ~/spitfire/spitfire-{{version}}.tar.gzKurun (Docker ya da Kubernetes satırı):
~/spitfire/install.sh docker --offline spitfire-offline-{{version}}-linux-amd64.tar.gz ~/spitfire/install.sh kubernetes --offline spitfire-offline-{{version}}-linux-amd64.tar.gz --registry harbor.ornek.local/spitfireBaşarı kontrolü: yukarıdaki
/healthzkomutu204yazar. İmza tutmazsa betik hiçbir şeye dokunmadan durur.
Betik internete çıkmaz. SHA256SUMS imzasını içine yazılı sürüm anahtarıyla (OpenSSL 3, Ed25519), her dosyayı da listeyle doğrular; imajı docker load ile yükler, kurulum dosyalarını açar (deploy/*/.env korunur) ve --image ile kurar. Postgres imajı makinede yoksa onu da yükler, varsa dokunmaz; sürüm değişiyorsa önce veritabanını yedekler, --rollback da aynı çalışır. Kubernetes'te cluster yerel imajları göremez, bu yüzden --registry zorunludur: imajlar REG/spitfire:<sürüm> ve REG/postgres:16 olarak gönderilir (önce docker login). Helm'de chart paketteki helm/spitfire-<sürüm>.tgz'dir: --set image.repository=REG/spitfire --set image.tag=<sürüm> --set postgres.image=REG/postgres:16. Runner sunucuları: install.sh runner --offline <paket>.
OpenSSL 3 olmayan sunucuda (ör. RHEL 8) betik paketi reddeder; o zaman spitfire.tr/kurulum'daki .sha256 değerini --offline-sha256 <değer> ile verin. Paketi OpenSSL 3 olan bir makinede elle de doğrulayabilirsiniz:
mkdir paket && tar -xzf spitfire-offline-{{version}}-linux-amd64.tar.gz -C paket && cd paket
{ printf 'spitfire-offline-v1\n'; cat SHA256SUMS; } > signed.txt
openssl base64 -d -A -in SHA256SUMS.sig -out SHA256SUMS.bin
openssl pkeyutl -verify -rawin -pubin -inkey spitfire-release.pub.pem -in signed.txt -sigfile SHA256SUMS.bin
sha256sum -c SHA256SUMSspitfire-release.pub.pem Spitfire'ın sürüm anahtarıdır (paketteki README.txt'de de yazar):
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAE7pSZPzN3PgBdeCyFwRvfMP2EWlKt87gSgRu84qu5Io=
-----END PUBLIC KEY-----Kurulu install.sh --offline'ı tanımıyorsa önce paketteki spitfire-<sürüm>.tar.gz'yi ~/spitfire'a açın (2. adım), sonra komutu çalıştırın. Windows'ta (install.ps1) --offline yoktur: paketi bir Linux makinede doğrulayın, docker load -i spitfire-image.tar ve docker load -i postgres-image.tar ile yükleyin, sonra & "$env:USERPROFILE\spitfire\install.ps1" docker -Image usespitfire/spitfire:<sürüm> çalıştırın.
Güncelleme listesini iç ağdan sunmak
Yeni sürümün arayüzde yine görünmesi için paketteki releases.json ile releases.json.sig'i iç ağdaki bir web sunucusuna koyup controller'a SPITFIRE_UPDATE_FEED=https://intranet.ornek.local/spitfire/releases.json verin (.sig aynı adreste olmalı). Liste imzalıdır, aynada değiştirilirse reddedilir. Her yeni paketle iki dosyayı da yenileyin. Ayna kullanmıyorsanız SPITFIRE_UPDATE_CHECK=off verip yenilikleri spitfire.tr/yenilikler'den takip edin.
Proxy arkasında kurulum
Kurulum komutunu HTTPS_PROXY (gerekirse HTTP_PROXY, NO_PROXY) tanımlıyken çalıştırın:
export HTTPS_PROXY=http://proxy.ornek.com:3128
export NO_PROXY=.ornek.local
curl -fsSL https://spitfire.sh | bash -s -- dockerBetik bu değerleri controller'a aktarır (Docker: deploy/docker/.env; Kubernetes: spitfire-proxy Secret'ı); controller güncelleme kontrolünü, webhook'ları, SSO çağrılarını ve açıksa sağlık verisi paylaşımını proxy'den yapar. Kurulumun kendi adları (localhost, postgres, controller…) NO_PROXY'ye kendiliğinden girer; iç ağdaki SSO sağlayıcısını ve webhook hedeflerini siz ekleyin. Sonraki çalıştırmada proxy vermezseniz önceki ayar korunur.
Sık karşılaşılan sorunlar
Belirti: Sürüm ve güncellemeler kartında Kontrol başarısız görünüyor.
Neden: Controller spitfire.tr'ye ulaşamıyor.
Çözüm: Proxy arkasındaysanız kurulum komutunu HTTPS_PROXY tanımlıyken yeniden çalıştırın; internetsiz kurulumda SPITFIRE_UPDATE_CHECK=off.