ChaosGrid

Distributed resilience lab and anti-fragility simulation for cloud-native systems.

📖 Overview

ChaosGrid is a full lab for resilience testing — injecting faults across a Kubernetes cluster through Envoy and Go tooling, then measuring how the system degrades and recovers.

Part of my . Built on the "" model.

🚀 Quick Start

# 1. Clone
git clone https://github.com/Kimosabey/chaos-grid.git
cd chaos-grid

# 2. Install
# (see docs/GETTING_STARTED.md for the full setup)

# 3. Run
docker compose up

✨ Key Features

• Cluster-wide fault injection
• Envoy-level network chaos
• Resilience and recovery metrics
• Repeatable experiment scenarios

🏗️ Architecture

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#ffffff','lineColor':'#2563eb','mainBkg':'#ffffff'}}}%%
graph LR
    A([Cluster])
    B([Fault Injection])
    C([Observe Degradation])
    D([Resilience Score])
    A --> B
    B --> C
    C --> D
    style A fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style B fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style C fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style D fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af

Loading

Measuring anti-fragility quantitatively rather than assuming the system is resilient.

See docs/ARCHITECTURE.md for the full HLD/LLD and design decisions.

🧰 Tech Stack

Layer	Technology	Role
Kubernetes	Kubernetes	Container orchestration
Go	Go	High-concurrency service core
Envoy	Envoy	L7 proxy & traffic control

📚 Documentation

• Architecture — high- and low-level design, decision log
• Getting Started — prerequisites, setup, environment
• Failure Scenarios — fault analysis and recovery
• Interview Q&A — deep-dive walkthrough

🔭 Future Enhancements

• Scenario catalog
• Automated game-days
• Regression on resilience scores

📄 License

Released under the MIT License.

👤 Author

Harshan Aiyappa Senior Full-Stack Hybrid AI Engineer Voice AI • Distributed Systems • Infrastructure