> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Topoloji 1: Test ve PoC

> Test ve Proof of Concept ortamlarında Apinizer'ı kurabilir, sistem gereksinimlerini belirleyebilir, ağ topolojisini yapılandırabilir, kapasite planlaması yapabilir ve donanım gereksinimlerini karşılayabilirsiniz.

Bu sayfa, Apinizer'ı **Test ve Proof of Concept (PoC)** ortamlarında kurmak isteyenler için hazırlanmıştır. Bu topoloji, hızlı kurulum, düşük kaynak gereksinimi ve minimum maliyet için tasarlanmıştır.

<Warning>
  **Önemli:** Bu topoloji **sadece** test, geliştirme ve PoC ortamları için uygundur. Production ortamları için kullanılmamalıdır. Yük testi yapmak için doğru konfigürasyonu değerlendirmek isterseniz lütfen [Benchmark Sonuçları](/tr/concepts/benchmark-sonuclari) sayfamıza bakınız.
</Warning>

## Genel Bakış

Topoloji 1, minimum kaynak gereksinimi ile hızlı kurulum sağlayan basit bir topolojidir. Tüm bileşenler 2 sunucu üzerinde çalışır.

### Mimari Yapı

<img src="https://mintcdn.com/apinizer/PjHeFMTcHBq5-E_G/images/concepts/singlecluster.drawio.png?fit=max&auto=format&n=PjHeFMTcHBq5-E_G&q=85&s=2655a1fc341b24a77ccab4b35e3bfb65" alt="Mimari Yapı" width="1000" data-path="images/concepts/singlecluster.drawio.png" />

## 1. Sistem Gereksinimleri

Detaylı sistem gereksinimleri için [Genel Bakış](/tr/concepts/deployment/genel-bakis) sayfasına bakabilirsiniz.

### İşletim Sistemi

* **Ubuntu Server 24.04 LTS** veya **RHEL 9.x**
* Minimum kernel versiyonu: 5.4+
* SELinux: Disabled (RHEL için) veya Permissive mode

### Yazılım Bileşenleri

| Bileşen               | Versiyon/Gereksinim                                         |
| --------------------- | ----------------------------------------------------------- |
| **Kubernetes**        | 1.31.0+ (veya desteklenen herhangi bir versiyon)            |
| **Docker/Containerd** | Kubernetes ile uyumlu versiyon                              |
| **MongoDB**           | Herhangi bir versiyon (Replica Set olarak yapılandırılmalı) |
| **Elasticsearch**     | 7.9.2+ (resmi desteklenen versiyon)                         |
| **Network Plugin**    | Flannel 0.27.4 (veya uyumlu)                                |

<Info>
  **Yazılım bileşenleri hakkında detaylı bilgi için:** [Genel Bakış - Apinizer'ın İhtiyaç Duyduğu Bileşenler](/tr/concepts/deployment/genel-bakis#apinizerın-ihtiyaç-duyduğu-bileşenler)
</Info>

### Ağ Gereksinimleri

* **Internet Erişimi**: Kurulum sırasında gerekli (offline kurulum için özel hazırlık gerekir)
* **DNS**: Çalışan DNS çözümleme
* **Firewall**: Gerekli portların açık olması

<Info>
  **Ağ topolojisi ve port gereksinimleri hakkında detaylı bilgi için:** [Ağ Topolojisi ve Port Gereksinimleri](/tr/concepts/deployment/ag-topolojisi)
</Info>

## 2. Donanım Gereksinimleri

Aşağıdaki gereksinimler tavsiye edilen **minimum** konfigürasyon için belirtilmiştir. Servis yüklerinize göre artırılmalıdır.

<Warning>
  **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ğerlendiriniz.**
</Warning>

<Warning>
  **Test/PoC kurulumlarını yük testi amacıyla kullanmayınız!** Yük testi yapmak için doğru konfigürasyonu değerlendirmek isterseniz lütfen [Benchmark Sonuçları](/tr/concepts/benchmark-sonuclari) sayfamıza bakınız veya bizimle iletişime geçiniz.
</Warning>

| No       | İşletim Sistemi                    | CPU | RAM  | Disk  | Kurulumlar                                                                                          |
| -------- | ---------------------------------- | --- | ---- | ----- | --------------------------------------------------------------------------------------------------- |
| Sunucu 1 | Ubuntu Server 24.04 LTS / RHEL 9.x | 4   | 16GB | 200GB | Kubernetes Control-Plane, Manager, Elasticsearch (Master+Data), Replica set MongoDB Single Instance |
| Sunucu 2 | Ubuntu Server 24.04 LTS / RHEL 9.x | 6   | 8GB  | 80GB  | Kubernetes Worker                                                                                   |

<Note>
  Worker node'larındaki sunucu kaynakları, gateway pod limitlerine (W4: 4 core / 4 GB) ek olarak Kubernetes sistem bileşenlerine (kubelet, kube-proxy, container runtime, işletim sistemi) ayrılan **\~2 core / \~4 GB** rezervasyonu kapsamaktadır.
</Note>

<Info>
  **Önemli**: Yukarıdaki CPU, disk ve RAM değerleri örnek olarak verilmiştir. Bu değerler, trafik hacmi, API sayısı, politika karmaşıklığı ve diğer faktörlere göre değişiklik gösterebilir. Gerçek donanım gereksinimlerinizi belirlemek için [Kapasite Planlama](/tr/concepts/deployment/kapasite-planlama) sayfasındaki kurallara göre hesaplama yapmanız önerilir.
</Info>

## 3. Ağ Topolojisi

### Basit Ağ Yapısı

Test/PoC ortamları için basit bir ağ yapısı yeterlidir. DMZ/LAN ayrımı opsiyoneldir.

**Ağ Yapısı:**

* **Internet**: Dış dünyadan gelen trafik, Firewall/Router üzerinden (Port 443/80) iç ağa yönlendirilir.
* **Sunucu 1**: Kubernetes Control-Plane, [MongoDB](/tr/concepts/temel-kavramlar/baglantilar) ve [Elasticsearch](/tr/concepts/temel-bilesenler/analytics-engine) bileşenlerini barındırır.
* **Sunucu 2**: Kubernetes Worker Node, [Manager](/tr/concepts/temel-bilesenler/api-manager), [Worker](/tr/concepts/temel-bilesenler/api-gateway) ve Cache bileşenlerini barındırır.

Bu basit yapı, test ve PoC ortamları için yeterli güvenlik ve performans sağlar. Production ortamları için daha gelişmiş ağ yapılandırmaları (DMZ/LAN ayrımı) önerilir.

<Info>
  **DMZ ve LAN zone'ları hakkında detaylı bilgi için:** [Genel Bakış - Temel Kavramlar](/tr/concepts/deployment/genel-bakis#temel-kavramlar) ve [Ağ Topolojisi ve Port Gereksinimleri](/tr/concepts/deployment/ag-topolojisi)
</Info>

### Port ve Firewall İzinleri

Eğer tüm sunucularınız aynı alt ağ üzerinde konumlanacak ve aralarında bir güvenlik duvarı bulunmayacaksa, güvenlik duvarı kuralları yalnızca internet'ten erişim ve konteyner ağ iletişimi için geçerli olacaktır. Sunucular arasındaki küme içi ve bileşenler arası iletişim portları, aynı alt ağ içinde doğrudan erişilebilir kabul edildiğinden, bu iletişimler için ek bir güvenlik duvarı kuralı tanımlanmasına gerek yoktur.

<Info>
  **Port gereksinimleri ve firewall kuralları hakkında detaylı bilgi için:** [Ağ Topolojisi ve Port Gereksinimleri](/tr/concepts/deployment/ag-topolojisi) sayfasına bakabilirsiniz. Bu sayfada Kubernetes, MongoDB, Elasticsearch ve Apinizer bileşenleri için tüm port gereksinimleri ve firewall kuralları detaylı olarak açıklanmıştır.
</Info>

## 4. Kapasite Planlama

Bu topoloji, **Tier 1** (Test/PoC) seviyesindeki düşük trafikli sistemler için tasarlanmıştır:

| Metrik                  | Değer                |
| ----------------------- | -------------------- |
| **Günlük İstek**        | \< 500,000 istek/gün |
| **Saniyede İstek**      | \< 10 istek/saniye   |
| **Peak Trafik**         | \< 50 istek/saniye   |
| **Eşzamanlı Kullanıcı** | \< 50 kullanıcı      |

<Info>
  **Kapasite planlama hakkında detaylı bilgi için:** [Kapasite Planlama](/tr/concepts/deployment/kapasite-planlama) sayfasına bakabilirsiniz. Bu sayfada trafik tahmini, donanım gereksinimleri, MongoDB ve Elasticsearch veri büyüklüğü hesaplamaları ve benchmark performans sonuçları detaylı olarak açıklanmıştır.
</Info>

## Kurulum Öncesi Checklist

Kuruluma başlamadan önce aşağıdaki hazırlıkları yapmalısınız:

| Kategori     | Kontrol Maddesi                                                           |
| ------------ | ------------------------------------------------------------------------- |
| **Altyapı**  | \[ ] 2 sunucu hazırlandı                                                  |
|              | \[ ] İşletim sistemi kuruldu (Ubuntu 24.04 LTS veya RHEL 9.x)             |
|              | \[ ] Sunucular arası ağ bağlantısı test edildi                            |
|              | \[ ] DNS çözümleme çalışıyor                                              |
|              | \[ ] Internet erişimi mevcut (offline kurulum için özel hazırlık yapıldı) |
| **Ağ**       | \[ ] Gerekli portlar açıldı                                               |
|              | \[ ] Firewall kuralları yapılandırıldı                                    |
|              | \[ ] Load balancer yapılandırması (opsiyonel)                             |
| **Yazılım**  | \[ ] Kubernetes kurulum paketleri hazır                                   |
|              | \[ ] MongoDB kurulum paketleri hazır                                      |
|              | \[ ] Elasticsearch kurulum paketleri hazır                                |
|              | \[ ] Apinizer image'leri erişilebilir (DockerHub veya private registry)   |
| **Güvenlik** | \[ ] SSH anahtarları yapılandırıldı                                       |
|              | \[ ] Sudo erişimi yapılandırıldı                                          |
|              | \[ ] Güvenlik güncellemeleri yapıldı                                      |

<Info>
  **Kurulum öncesi detaylı öneriler için:** [Kurulum Öncesi Öneriler](/tr/concepts/deployment/kurulum-oncesi-oneriler) sayfasına bakabilirsiniz.
</Info>

## Kullanım Senaryoları

Bu topoloji, Proof of Concept (POC), test ortamları, eğitim amaçlı kullanım, düşük trafikli uygulamalar (\< 500K istek/gün), hızlı kurulum gereksinimleri ve sınırlı bütçe durumları için idealdir.

<Info>
  **Topoloji seçim kılavuzu ve kullanım senaryoları hakkında detaylı bilgi için:** [Deployment Modelleri](/tr/concepts/deployment/deployment-modelleri) sayfasına bakabilirsiniz.
</Info>

## Sınırlamalar ve Dikkat Edilmesi Gerekenler

<Warning>
  **Bu topolojinin sınırlamaları:**

  * Production ortamları için uygun değildir
  * Yüksek erişilebilirlik yok (tek nokta arıza riski)
  * Yük testi için kullanılmamalıdır
  * Yüksek trafikli uygulamalar için uygun değildir
  * Veritabanı tek nokta arıza riski taşır
  * Otomatik failover yok
</Warning>