k8s_vGateway

Kubernetes Gateway API Implementation Comparison Tool

A CLI tool to test and compare 7 different Gateway API implementations on Kubernetes with KubeVirt support.

Supported Gateway Implementations

• NGINX Gateway Fabric
• Envoy Gateway
• Istio
• Cilium
• Contour
• Traefik
• HAProxy

Features

• 17 Gateway API conformance tests
• Performance benchmarking with multiple load patterns
• KubeVirt VM management for isolated testing
• Multiple output formats (table, JSON, CSV, Markdown)
• Configuration profiles for different test scenarios
• Automated gateway deployment and health checks

Installation

Pre-built Binaries

Download the latest release for your platform:

# Linux (x86_64)
curl -LO https://github.com/hephaex/k8s_vGateway/releases/latest/download/gateway-poc-linux-amd64
chmod +x gateway-poc-linux-amd64
sudo mv gateway-poc-linux-amd64 /usr/local/bin/gateway-poc

# macOS (ARM64)
curl -LO https://github.com/hephaex/k8s_vGateway/releases/latest/download/gateway-poc-darwin-arm64
chmod +x gateway-poc-darwin-arm64
sudo mv gateway-poc-darwin-arm64 /usr/local/bin/gateway-poc

From Source

git clone https://github.com/hephaex/k8s_vGateway.git
cd k8s_vGateway
cargo build --release

Requirements

• Kubernetes cluster with Gateway API CRDs installed
• kubectl configured with cluster access
• Rust 1.70+ (only for building from source)

Usage

Run Tests

# Test specific gateway
gateway-poc test --gateway nginx --ip 10.0.0.1

# Run single test
gateway-poc test --gateway envoy --test 1

# Run all tests with multiple rounds
gateway-poc test --gateway istio --all --rounds 10

# Parallel execution
gateway-poc test --gateway cilium --all --parallel --concurrent 4

List Available Tests

gateway-poc list --detailed
gateway-poc list --gateways

Deploy Gateway

# Install Gateway API CRDs
gateway-poc deploy crds

# Install gateway implementation
gateway-poc deploy install nginx --namespace gateway-system

# Check gateway health
gateway-poc deploy health nginx --ip 10.0.0.1

Benchmarking

# Run benchmark
gateway-poc benchmark run --gateway nginx --ip 10.0.0.1 --duration 60 --rps 1000

# Compare multiple gateways
gateway-poc benchmark compare --gateways nginx,envoy,istio --ip 10.0.0.1

KubeVirt VM Management

# Create test VMs
gateway-poc vm create --workers 2 --cpu 4 --memory 8

# Check VM status
gateway-poc vm status

# Delete VMs
gateway-poc vm delete --all

Configuration

# Initialize config file
gateway-poc config init

# Show current configuration
gateway-poc config show

# List available profiles
gateway-poc config profiles --detailed

Test Categories

Output Formats

• table - Human-readable table format
• json - JSON output
• json-pretty - Pretty-printed JSON
• csv - CSV format for spreadsheets
• summary - Condensed summary view

Environment Variables

Documentation

• CHANGELOG - Release history
• CONTRIBUTING - Contribution guidelines
• SECURITY - Security policy

License

GPL-3.0

Author

hephaex@gmail.com