Overview
Topology 1 is a simple topology that provides quick installation with minimum resource requirements. All components run on 2 servers.Architectural Structure
1. System Requirements
For detailed system requirements, you can refer to the Overview page.Operating System
- Ubuntu Server 24.04 LTS or RHEL 9.x
- Minimum kernel version: 5.4+
- SELinux: Disabled (for RHEL) or Permissive mode
Software Components
| Component | Version/Requirement |
|---|---|
| Kubernetes | 1.31.0+ (or any supported version) |
| Docker/Containerd | Version compatible with Kubernetes |
| MongoDB | Any version (must be configured as Replica Set) |
| Elasticsearch | 7.9.2+ (officially supported version) |
| Network Plugin | Flannel 0.27.4 (or compatible) |
For detailed information about software components: Overview - Components Required by Apinizer
Network Requirements
- Internet Access: Required during installation (special preparation required for offline installation)
- DNS: Working DNS resolution
- Firewall: Required ports must be open
For detailed information about network topology and port requirements: Network Topology and Port Requirements
2. Hardware Requirements
The requirements below are specified for the recommended minimum configuration. They should be increased according to your service loads.| No | Operating System | CPU | RAM | Disk | Installations |
|---|---|---|---|---|---|
| Server 1 | Ubuntu Server 24.04 LTS / RHEL 9.x | 8 | 32GB | 200GB | Kubernetes Control-Plane, Manager, Elasticsearch (Master+Data), Replica set MongoDB Single Instance |
| Server 2 | Ubuntu Server 24.04 LTS / RHEL 9.x | 4 | 4GB | 80GB | Kubernetes Worker |
Important: The CPU, disk, and RAM values above are given as examples. These values may vary according to traffic volume, number of APIs, policy complexity, and other factors. To determine your actual hardware requirements, it is recommended to calculate according to the rules on the Capacity Planning page.
3. Network Topology
Simple Network Structure
A simple network structure is sufficient for Test/PoC environments. DMZ/LAN separation is optional. Network Structure:- Internet: Traffic from the outside world is directed to the internal network through Firewall/Router (Port 443/80).
- Server 1: Hosts Kubernetes Control-Plane, MongoDB, and Elasticsearch components.
- Server 2: Hosts Kubernetes Worker Node, Manager, Worker, and Cache components.
For detailed information about DMZ and LAN zones: Overview - Core Concepts and Network Topology and Port Requirements
Port and Firewall Permissions
If all your servers will be located on the same subnet and there will be no firewall between them, firewall rules will only apply to internet access and container network communication. Since inter-server cluster and inter-component communication ports are considered directly accessible within the same subnet, there is no need to define an additional firewall rule for these communications.For detailed information about port requirements and firewall rules: You can refer to the Network Topology and Port Requirements page. This page explains in detail all port requirements and firewall rules for Kubernetes, MongoDB, Elasticsearch, and Apinizer components.
4. Capacity Planning
This topology is designed for Tier 1 (Test/PoC) level low-traffic systems:| Metric | Value |
|---|---|
| Daily Requests | < 500,000 requests/day |
| Requests per Second | < 10 requests/second |
| Peak Traffic | < 50 requests/second |
| Concurrent Users | < 50 users |
For detailed information about capacity planning: You can refer to the Capacity Planning page. This page explains in detail traffic estimation, hardware requirements, MongoDB and Elasticsearch data size calculations, and benchmark performance results.
Pre-Installation Checklist
Before starting installation, you should make the following preparations:| Category | Check Item |
|---|---|
| Infrastructure | [ ] 2 servers prepared |
| [ ] Operating system installed (Ubuntu 24.04 LTS or RHEL 9.x) | |
| [ ] Network connectivity between servers tested | |
| [ ] DNS resolution working | |
| [ ] Internet access available (special preparation done for offline installation) | |
| Network | [ ] Required ports opened |
| [ ] Firewall rules configured | |
| [ ] Load balancer configuration (optional) | |
| Software | [ ] Kubernetes installation packages ready |
| [ ] MongoDB installation packages ready | |
| [ ] Elasticsearch installation packages ready | |
| [ ] Apinizer images accessible (DockerHub or private registry) | |
| Security | [ ] SSH keys configured |
| [ ] Sudo access configured | |
| [ ] Security updates performed |
For detailed pre-installation recommendations: You can refer to the Pre-Installation Recommendations page.
Usage Scenarios
This topology is ideal for Proof of Concept (POC), test environments, training purposes, low-traffic applications (< 500K requests/day), quick installation requirements, and situations with limited budget.For detailed information about topology selection guide and usage scenarios: You can refer to the Deployment Models page.