Learn¶
This section explains the what and the why behind the Orofi infrastructure. Read these pages to build a mental model before diving into operational guides.
Pages in This Section¶
| Page | What You'll Learn |
|---|---|
| System Overview | The business context and high-level description of what we're running |
| Architecture Overview | How all the pieces fit together, with diagrams |
| Infrastructure Topology | Full network layout, GCP projects, VPCs, and resource placement |
| Security Model | IAM, network security, secrets, mTLS, and zero-trust patterns |
| Environments | Dev vs Staging vs Production — what differs and why |
| Technology Stack | Summary of every technology choice with rationale |
| GCP & GKE | GCP project structure, GKE cluster details, node pools |
| ArgoCD & GitOps | How deployments work end-to-end |
| Terraform & Terragrunt | Module architecture and IaC composition |
| Databases | Cloud SQL, MongoDB, Kafka — configuration and topology |
| Networking | Istio, DNS, TLS, Cloudflare, ingress routing |
Recommended Reading Order¶
New engineer: System Overview → Architecture Overview → Environments → Technology Stack Overview → GCP & GKE
Before deploying: Architecture Overview → ArgoCD & GitOps → Networking
Before touching infra: Terraform & Terragrunt → Infrastructure Topology → Security Model