Setup - Server Requirements¶

Bu belge, EnQualify üretim (production) kurulumları için minimum donanım ve kaynak gereksinimlerini sunar.

Genel Notlar¶

• CPU, RAM ve Disk değerleri minimum gereksinimlerdir. Üretim ortamları bu eşiklerin altına düşmemelidir.
• ADAuth API isteğe bağlıdır — yalnızca AD login entegrasyonu etkinleştirildiğinde gereklidir.
• VideoCall bileşenleri (VideoResize, Signalling, CoTurn) isteğe bağlıdır — yalnızca video görüşme özelliği etkinleştirildiğinde gereklidir.
• File Storage isteğe bağlıdır — Video Görüşme kaydı veya Ekran Kaydı etkinleştirildiğinde gereklidir.
• Test, staging ve yedekleme (backup) sistemleri bu gereksinimlere dahil değildir.
• Düşük hacimli kurulumlarda (< 1.000 işlem/gün), operasyonel olarak kabul edilebilir olduğu yerlerde kaynaklar bileşenler arasında paylaşılabilir.

Seçenek A — Klasik Kurulum (VM / Bare-Metal)¶

Önerilen kullanım: Geleneksel şirket içi (on-premises) veya özel bulut altyapısı kullanan kuruluşlar (VMware, Hyper-V, bare-metal sunucular).

İki kurulum topolojisi mevcuttur:

• Birleşik (Consolidated Servers): Birden fazla EnQualify bileşeni tek bir VM/sunucuda çalışır. Makine sayısını azaltır, daha küçük kurulumlara uygundur.
• Konteyner Tabanlı (Per-Container): Her bileşen ayrı VM'lerde kendi Docker konteynerinde çalışır. Bireysel servisleri ölçeklendirmek ve güncellemek daha kolaydır.

A.1 — Birleşik Topoloji (Consolidated Servers)¶

Sunucu başına birden fazla bileşen birleştirilir. Geleneksel altyapıda orta–büyük ölçekli kurulumlara uygundur.

Konfigürasyon: Base (Temel)¶

Yalnızca çekirdek EnQualify bileşenleri. İsteğe bağlı modül yok.

Konfigürasyon: Screen Recording (Ekran Kaydı)¶

Ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: Video Call (Video Görüşme)¶

Video görüşmeyi (WebRTC) içerir.

Konfigürasyon: Video Call + Screen Recording¶

Video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: Video Call + Screen Recording + STT-TTS¶

Video görüşme (WebRTC), ekran kaydı / dosya depolama, Speech To Text (STT) ve Text To Speech (TTS) içerir.

AD Authentication¶

Konfigürasyon: AD Authentication (AD Kimlik Doğrulama)¶

AD kimlik doğrulama entegrasyonunu içerir.

Konfigürasyon: AD Authentication + Screen Recording¶

AD kimlik doğrulama entegrasyonu ve ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: AD Authentication + Video Call¶

AD kimlik doğrulama entegrasyonu ve video görüşme (WebRTC) içerir.

Konfigürasyon: AD Authentication + Video Call + Screen Recording¶

AD kimlik doğrulama entegrasyonu, video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

A.2 — Konteyner Tabanlı Topoloji (Per-Container)¶

Her servis kendi Docker konteynerinde çalışır. Bireysel servis ölçeklendirmesi gerektiren Kubernetes'e hazır veya Docker tabanlı kurulumlara uygundur.

Konfigürasyon: Base (Temel)¶

Yalnızca çekirdek EnQualify bileşenleri. İsteğe bağlı modül yok.

Konfigürasyon: Screen Recording (Ekran Kaydı)¶

Ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: Video Call (Video Görüşme)¶

Video görüşmeyi (WebRTC) içerir.

Konfigürasyon: Video Call + Screen Recording¶

Video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: Video Call + Screen Recording + STT-TTS¶

Video görüşme (WebRTC), ekran kaydı / dosya depolama, Speech To Text (STT) ve Text To Speech (TTS) içerir.

Konfigürasyon: AD Authentication (AD Kimlik Doğrulama)¶

AD kimlik doğrulama entegrasyonunu içerir.

Konfigürasyon: AD Authentication + Screen Recording¶

AD kimlik doğrulama entegrasyonu ve ekran kaydı / dosya depolamayı içerir.

Konfigürasyon: AD Authentication + Video Call¶

AD kimlik doğrulama entegrasyonu ve video görüşme (WebRTC) içerir.

Konfigürasyon: AD Authentication + Video Call + Screen Recording¶

AD kimlik doğrulama entegrasyonu, video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

Seçenek B — Bulut-Yerel Kurulum (Kubernetes)

Önerilen kullanım: Modern bulut altyapısındaki kuruluşlar (AWS EKS, Azure AKS, Google GKE veya şirket içi Kubernetes kümeleri).

Ana avantaj: Kaynak talepleri (requests) düşük başlar. Horizontal Pod Autoscaler (HPA), gerçek işlem yüküne göre pod’ları otomatik ölçeklendirir. Satın alma sırasında aşırı kaynak ayırma (over-provisioning) gerekmez.

• • HPA hedefi: CPU kullanımı ≥ %70 olduğunda ölçek genişletme (scale-out) tetiklenir. Eşiğin altında 5 dakika kalınırsa ölçek daraltma (scale-in) gerçekleşir.
• Yönetilen veritabanı (RDS / Azure DB / Cloud SQL), DB sunucu boyutlandırma sorunlarını ortadan kaldırmak için kuvvetle önerilir.
• ADAuth API bir Windows node pool üzerinde çalışır; Linux üzerinde konteynerize edilemez.

B.0 — Kubernetes Kaynak Notasyonu — Terminoloji¶

Bu belgedeki Kubernetes konfigürasyon tabloları aşağıdaki birim ve terimleri kullanır. Bunlar standart Kubernetes kaynak notasyonudur.

Neden GB/MB değil? Kubernetes bellek için dahili olarak ikili (taban-2) aritmetik kullanır. ‘Mi’ ve ‘Gi’ yazmak belirsizliği önler; 1 GB (ondalık) ≠ 1 GiB (ikili). Bu belgedeki tüm bellek değerleri ikili birimlerdedir (Mi / Gi).

CPU request ile limit farkı: request=250m, limit=500m olan bir pod her zaman 0,25 çekirdek alır. Node’da boş kapasite varsa 0,5 çekirdeğe kadar çıkabilir (burst).

B.1 — Referans Mimari¶

• • Platform: EKS (AWS) / AKS (Azure) / GKE (GCP) / Şirket içi Kubernetes 1.26+
• Deployment: Helm Chart. Her EnQualify servisi için bir chart; her ortam için values.yaml override’ları.
• Ingress: NGINX Ingress Controller veya eşdeğeri (EKS’te ALB, AKS’te Application Gateway)
• Service Mesh: İsteğe bağlı. Servisler arası mTLS için Istio veya Linkerd.
• Kalıcı Depolama: DB volume’leri için PVC (ReadWriteOnce); File Storage için ReadWriteMany (EFS / Azure Files / GCS Fuse)
• Secrets: Kubernetes Secrets veya HashiCorp Vault entegrasyonu

B.2 — Horizontal Pod Autoscaler (HPA) Konfigürasyonu¶

Her AI ve API iş yükü HPA ile yapılandırılır. enqualify-aiapp için örnek:

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
spec:
  minReplicas: 1
  maxReplicas: 4
  metrics:
    - type: Resource
      resource:
        name: cpu
        target:
          type: Utilization
          averageUtilization: 70

B.3 — POC / Minimum Başlangıç Konfigürasyonu¶

EnQualify’ı çalışır hale getirmek için gereken minimum kaynak talepleri. Kavram kanıtı (proof-of-concept) ve düşük hacimli üretim (< 1.000 işlem/gün) için uygundur. Ani yükü (burst) HPA otomatik yönetir.

POC Konfigürasyonu: Base (Temel)¶

Yalnızca çekirdek EnQualify bileşenleri. İsteğe bağlı modül yok.

POC Konfigürasyonu: Screen Recording (Ekran Kaydı)¶

Ekran kaydı / dosya depolamayı içerir.

POC Konfigürasyonu: Video Call (Video Görüşme)¶

Video görüşmeyi (WebRTC) içerir.

POC Konfigürasyonu: Video Call + Screen Recording¶

Video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

POC Konfigürasyonu: Video Call + Screen Recording + STT-TTS¶

Video görüşme (WebRTC), ekran kaydı / dosya depolama, Speech To Text (STT) ve Text To Speech (TTS) içerir.

POC Konfigürasyonu: AD Authentication¶

AD kimlik doğrulama entegrasyonunu içerir.

POC Konfigürasyonu: AD Authentication + Screen Recording¶

AD kimlik doğrulama entegrasyonu ve ekran kaydı / dosya depolamayı içerir.

POC Konfigürasyonu: AD Authentication + Video Call¶

AD kimlik doğrulama entegrasyonu ve video görüşme (WebRTC) içerir.

POC Konfigürasyonu: AD Authentication + Video Call + Screen Recording¶

AD kimlik doğrulama entegrasyonu, video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

B.4 — Üretim Ölçeği Konfigürasyonu¶

Üretim iş yükleri için önerilen kaynak tahsisleri (> 1.000 işlem/gün). Replikalar, tanımlanan maksimuma kadar HPA aracılığıyla otomatik ölçeklenir.

Üretim Konfigürasyonu: Base (Temel)¶

Yalnızca çekirdek EnQualify bileşenleri. İsteğe bağlı modül yok.

Üretim Konfigürasyonu: Screen Recording (Ekran Kaydı)¶

Ekran kaydı / dosya depolamayı içerir.

Üretim Konfigürasyonu: Video Call (Video Görüşme)¶

Video görüşmeyi (WebRTC) içerir.

Üretim Konfigürasyonu: Video Call + Screen Recording¶

Video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

Üretim Konfigürasyonu: Video Call + Screen Recording + STT-TTS

Video görüşme (WebRTC), ekran kaydı / dosya depolama, Speech To Text (STT) ve Text To Speech (TTS) içerir.

Üretim Konfigürasyonu: AD Authentication¶

AD kimlik doğrulama entegrasyonunu içerir.

Üretim Konfigürasyonu: AD Authentication + Screen Recording¶

AD kimlik doğrulama entegrasyonu ve ekran kaydı / dosya depolamayı içerir.

Üretim Konfigürasyonu: AD Authentication + Video Call¶

AD kimlik doğrulama entegrasyonu ve video görüşme (WebRTC) içerir.

Üretim Konfigürasyonu: AD Authentication + Video Call + Screen Recording¶

AD kimlik doğrulama entegrasyonu, video görüşme (WebRTC) ve ekran kaydı / dosya depolamayı içerir.

Kurulum Seçeneği Karşılaştırması¶

Bu doküman Enqura Engineering tarafından güncel tutulmaktadır. Boyutlandırma soruları için çözüm mimarisi ekibiyle iletişime geçiniz.