Kurulumlara Genel Bakış
Apinizer üç farklı çalışma ortamında kurulabilir: Kubernetes, Docker ve Linux / VM. Her yöntemin farklı operasyonel maliyeti ve hedef kitlesi vardır. Detaylı karşılaştırma için aşağıdaki Yöntem Seçimi sekmesine bakın.
Apinizer üretim ortamı için tek sunucuya kurulum yapılmasını tavsiye etmez. Böyle bir kurulum konfigürasyonunu sadece PoC ortamları için değerlendirin.
- Yöntem Seçimi
- Kurulum Öncesi Kararlar
- Erişim ve Port
- Kurulum Topolojileri
Apinizer'ı çalıştırmanın iki yolu var: konteyner veya standalone.
Tüm Apinizer bileşenlerini kendi Kubernetes cluster'ınızda ya da Docker host'unuzda resmi apinizercloud imajları ile, veya bare-metal Linux sunucuda imzalı tarball installer'lar ile çalıştırın. Aynı build'ler, aynı sürümler, sizin altyapınız.
Konteyner tarafında Kubernetes üretim, HA ve otomatik ölçekleme için; Docker orta ölçek ve hızlı PoC için tercih edilir. Standalone tarafında Sanal Sunucu kurulumu regüle ortamlar (banka, kamu), air-gapped ağlar ve gömülü JDK isteyen senaryolar için uygundur. Aşağıdaki karar matrisini inceleyerek size uygun yöntemi seçin.
Hızlı Karar Matrisi
| Senaryo | Önerilen Yöntem |
|---|---|
| Kubernetes cluster mevcut, üretim, HA + otomatik ölçeklendirme | Kubernetes |
| Tek/birkaç sunucu, konteyner deneyimi var, hızlı PoC | Docker |
| Regüle ortam (banka/kamu), K8s/Docker yasak veya kısıtlı | Linux / VM |
| Çevrimdışı (air-gapped) kurulum | Linux / VM (offline kurulum) |
| 5+ Worker, dağıtık quota / circuit breaker | Kubernetes veya Linux / VM çoklu node (Cache cluster) |
| Geliştirici makinesi, geçici test ortamı | Docker (docker-compose) |
Yöntem Karşılaştırması
| Kriter | Kubernetes | Docker | Linux / VM |
|---|---|---|---|
| Operasyonel kompleksite | Yüksek | Orta | Düşük |
| Öğrenme eğrisi | Dik | Orta | Düz |
| Yüksek erişilebilirlik (HA) | Yerleşik | Compose / Swarm ile | Çoklu node manuel |
| Otomatik ölçeklendirme | HPA / VPA | Yok | Yok |
| Sıfır kesintili güncelleme | Rolling update | Tek tek replika rotasyonu | Manuel + LB |
| Gömülü JDK | Hayır (image içinde JRE) | Hayır (image içinde JRE) | Evet (Temurin 25 paketle) |
| Air-gapped destek | Helm + private registry | Private registry | Native (offline tarball) |
| Resmî sertifika gereksinimi | TLS Ingress / cert-manager | Reverse proxy / self-terminate | Reverse proxy / self-terminate |
| Şifrelenmiş yapılandırma | K8s Secret | Docker Secret / env | Jasypt master key + ENC(...) |
| Donanım gereksinimi (üretim) | 3+ node cluster, 8+ vCPU/node | 1-3 host, 4+ vCPU/host | 1-3 host, 4+ vCPU/host |
| Bulut sağlayıcı entegrasyonu | EKS / AKS / GKE / OpenShift | Bulut VM üzerinde | Bulut VM üzerinde |
Ne Zaman Hangisini Seçmemeli?
Kubernetes seçme
- Tek sunucu PoC kuracaksanız — K8s overhead'i bu boyutta orantısız.
- Ekibinizde K8s deneyimi yoksa ve öğrenmek için zaman ayıramayacaksanız.
- Regüle ortam K8s'i yasaklamışsa (bazı banka/kamu ortamları).
Docker seçme
- 5+ Worker ölçeğinde üretim çalıştıracaksanız — Hazelcast cluster'ı yönetmek Compose'da ağırlaşır.
- Otomatik failover ihtiyacı varsa (Docker tek başına HA orchestration vermez).
- Container runtime kurumsal politikayla yasaksa.
Linux / VM seçme
- Çoklu node ile dinamik ölçeklendirme istiyorsanız — el ile node ekleme/çıkarma sürtünmeli.
- Konteyner ekosistemi (CI/CD imaj registry, scan pipeline) zaten oturmuşsa — VM ile entegrasyon ek iş.
Ortak Ön Hazırlık — MongoDB
MongoDB kurulumu zorunludur — Apinizer'ı çalıştırmadan önce ayağa kalkmış bir MongoDB instance'ınız olmalı. Manager metadata'sı, deploy edilmiş proxy snapshot'ları, Integration scheduler kuyruğu ve audit kayıtları tamamen MongoDB üzerinde tutulur. Hangi runtime'ı (Kubernetes, Docker veya Sanal Sunucu) seçerseniz seçin bu bağımlılık değişmez.
Üretim için replica set önerilir; tek node sadece PoC / geliştirme için uygundur. Kurulum adımları için → MongoDB Kurulumu sayfasından devam edin.
Apinizer kurulumu öncesi karar verilmesi gereken konular aşağıda kategori bazlı toplanmıştır. Her kategori, ilgili konudaki kritik karar noktalarını ve önerileri gösterir.
Kurulum ve Altyapı
Apinizer'ın ihtiyaç duyduğu Kubernetes Cluster ve MongoDB gibi uygulamalar kurulacak mı hazırda var ve onlar kullanılacak mı?
- Kurumunuzda hazırda bu bileşenler varsa bunların kullanılması
- Kurulum yapılacaksa ekibiniz tarafından hazırlanması
- Kurulum yapılacaksa Apinizer ekibi tarafından yapılması
- Kurulum Apinizer ekibi tarafından yapılacaksa ilgili sunucular Kurulum için Erişim ve Port Gereksinimleri bölümündeki erişimlere sahip olmalıdır
Kurulacaksa kurumunuz çalışanları mı kuracak Apinizer ekibine sunucu mu tahsis edilecek?
Bu karar, kurulum sürecinin kim tarafından yönetileceğini belirler.
Apinizer ekibi tarafından kurulacaksa sunucularda internet erişimi kısıtlı ya da tam şekilde olacak mı?
Internet erişimi durumu, kurulum yöntemini (online/offline) etkiler.
Ağ ve Güvenlik
Apinizer'ın kurulacağı ağı kontrol eden ve güvenlik sıkılaştırması yapan WAF ve firewall dışında bir ürün var mı?
Apinizer'ın bulunduğu cluster'ın iç trafiğini de engelleyebildiği için bu tarz bir ürün varsa bunun bildirilmesi, olası sorunlarda çözüm arayışını hızlandıracağı için önemlidir. Bu bilgi kurumunuz Ağ ve Güvenlik Birimi çalışanlarından edinilebilir.
Apinizer'ın kurulacağı ağda 10.244.x.x bloğunda bir kullanım mevcut mu?
Kullanılıyorsa Apinizer kurulumu başka bir blok üzerine kurulması gerekeceğinden kurumunuz network ekibinden bu bilgi alınmalıdır.
Port ve DNS
Apinizer bulunduğu sunucularda hangi portlardan yayın yapmalıdır?
- 30000-32767 aralığından Manager için 32080, Worker için 30080 (HTTP) ve 30081 (HTTPS) olacak şekilde
- Kurumunuz DevOps Ekibi yönetiminde ayarlanacak portlarda (yine aynı aralıktan ya da nginx ingress kullanarak)
Apinizer'ın erişeceği DNS'ler Apinizer'ın bulunacağı sunucularda otomatik olarak çözülecek mi? Eğer hayır ise bu IP-host tanımları elde mevcut olarak hazır mı?
- Bu adresler çok nadir de olsa değişebileceği için sunucuların otomatik çözeceği şekilde ayarlanması
- Hostname-IP ikililerinin liste olarak Apinizer'a eklenmek için hazırlanması
Apinizer arayüzü ve worker'lar DNS üzerinden mi kullanılacak? Evet ise DNS'ler nasıl olacak?
apiyonetim.kurum.comveapi.kurum.comgibi adresler
SSL ve NAT
SSL sonlandırma nerede yapılacak?
- Kurumunuza ait güvenlik duvarında
- Kurumunuzun DNS yönlendirmesi ve load balans işlemlerini gerçekleştirdiği uygulamada
- Apinizer worker uygulamalarında
Apinizer kurumunuz dışında da kullanılacaksa hangi IP'den dışarı çıkacaktır? Apinizer sunucularının bu adresten çıkabilmesi için gerekli (NAT) işlemler gerçekleştirildi mi?
- Kurumunuzun mevcut çıkışının değiştirilmemesi, Apinizer'ın da bu adresten çıkması
Worker ve Yönetim
Apinizer'ın worker uygulaması (Core ve RAM kullanımı, JVM parametreleri) nasıl ayarlanacak?
- Mevcut lisansınızı iki ya da üçe bölüp buna uygun JVM parametrelerini girip birden fazla konteynıra dağıtarak
- Kurumunuzun uyguladığı politikaya göre farklı ayarlarla
Apinizer'ın üzerine kurulacağı Kubernetes sistemleri nasıl yönetilecek?
- Apinizer arayüzünden
- Kurumunuza ait yöntemler ile
Loglama ve Yedekleme
Trafik logları nereye yazılmalıdır?
- Apinizer'ın kuracağı Elasticsearch ile tahsis edilen sunuculardan birine
- Kurumunuzun ayarladığı başka bir uygulamaya
Trafik logları Apinizer'ın yönettiği Elasticsearch'te ise buradaki verilerin yedeği nasıl alınacaktır?
- Kurumunuz Sistem ekibi çalışanları logların yazıldığı diski olduğu gibi yedekleyecek
- Kurumunuz Sistem ekibi çalışanları logların bulunduğu sunucuyu olduğu gibi yedekleyecek
- Snapshot politikasıyla belirli bir sunucudaki belirli bir adrese gönderilmesi istenecek ve loglar burada yedeklenecek
Trafik loglarında görünmemesi gereken hassas bilgiler var mı? Varsa bunlar nelerdir? Mesajın hangi kısımlarında görünmemelidir?
- Kurumunuza ait Bilgi Güvenliği Ekibinden kurum politikası istenebilir
- Tckn ve TcKimlikNo gibi kişisel veri tutan anahtar değerler
Uygulama ve Token alma logları (ayarları aktif ise) nereye yazılmalıdır?
- Apinizer'ın konfigürasyon veritabanına
- Kurumunuzun ayarladığı başka bir uygulamaya
Veritabanında tutulacak olan loglar varsa bu büyüme nasıl kontrol altında tutulacaktır?
- Bu loglar belirli sürelerde silinecek
- Disk doldukça genişletilecek
Kullanıcı Yönetimi ve Destek
Apinizer arayüzüne ilk kurulumla oluşturulan admin kullanıcı hesabı kullanılacak mı? Evet ise kimin tarafından kullanılacak?
- Apinizer'ı varsa Entegrasyon Biriminiz çalışanlarının kullanması, kullanacak kişilere kendilerine ait ve yetkili kullanıcı hesapları oluşturulması, admin hesabının devredışı bırakılması
- Admin kullanıcısının Apinizer'dan sorumlu tek bir kişi tarafından kullanılması, kullanacak diğer kişilere yeni kullanıcılar tanımlanması