kilao is a local Kubernetes learning stack — a monorepo of Go microservices plus the cloud-native
platform around them (observability, serverless, ingress, data, and OSS cost/optimization tooling)
running on kind. This index links every diagram, runbook, ADR, and the per-leg guides.
Start the stack with make up && make platform && make deploy; see the runbooks to
extend it and the traceability runbook to watch it work.
Rendered natively by GitHub; validated in CI by scripts/docs-render-check.sh.
- Full-stack overview — host → Docker → kind → platform / apps / functions / GitOps.
- Observability view — services → OTel Collector → Jaeger / Prometheus / Loki → Grafana.
- Microservice topology — the 5 services + serverless bridge, by transport.
- Request / trace sequence — the async order saga, end to end.
- Cost-optimization loop — rightsize → re-pack → cost drop + scale-to-zero.
- 01 — Add a Go microservice
- 02 — Add a Knative serverless function
- 03 — See traceability + run the test-case flow in Jaeger
- 04 — Cloud graduation (EKS) + teardown
- 0001 — Traefik over ingress-nginx
- 0002 — Knative for serverless
- 0003 — Terraform (not AWS SAM) for cloud graduation
- 0004 — Karpenter + KWOK locally
- 0005 — NATS core vs JetStream for messaging
- 0006 — OpenTelemetry Collector as the telemetry hub
- 0007 — Grafana Alloy over Promtail for logs
- 0008 — Descheduler for local consolidation
- 0009 — CloudNativePG + Redis for data stores
Narrative walkthroughs of each system leg, each with a make <x>-demo you can run:
- Ingress — Traefik + Gateway API + cloud-provider-kind LoadBalancer.
- Cost visibility — OpenCost synthetic per-namespace allocation.
- Rightsizing — VPA + Goldilocks + KRR + in-place resize.
- KRR report — captured Robusta KRR rightsizing output.
- Node optimization — KWOK + Karpenter + Descheduler mechanics.
- Optimization loop — rightsize → resize → Descheduler → cost drop.
- Serverless — Knative Serving (echo) + Eventing (order-receipt) + always-on twin.
- Tier-1 patterns — GitOps (ArgoCD), External Secrets, circuit-breaker resilience.
- Tier-2 patterns — saga orchestration, transactional outbox, rate limiting.
- Cross-platform parity — macOS vs Ubuntu 26.04 bootstrap differences.