kensan-lab¶
Enterprise-grade Kubernetes on bare-metal — a reference architecture for platform engineering.
A bare-metal Kubernetes homelab built with technologies typical of enterprise platform engineering — Argo CD for GitOps, Istio for service mesh, Backstage for developer self-service, and observability with Prometheus, Grafana, Loki, and Tempo. All running on Raspberry Pis and a mini PC.
Try kind first; treat bare metal as a reference
The kind path is the tested, automated way to experience the platform. The bare-metal pages document the live cluster's design and current build steps, but a clean-room bootstrap has not yet been verified end to end. Ansible and Makefile automation is planned. Start with the kind walkthrough; use the bare-metal bootstrap pages as a reference.
Architecture¶
Each domain has an architecture page — design thesis, component map, diagrams, and the rationale behind the choices:
| Domain | One-liner |
|---|---|
| Argo CD | One root App-of-Apps, Git as the only actor; ApplicationSet only where structure is uniform |
| Network · Cloudflare Tunnel | Cilium CNI + L2 LB, Istio mesh, Gateway API edge; Zero Trust internet exposure |
| Auth | Keycloak OIDC, enforced once at the Gateway (oauth2-proxy ext_authz) |
| Secrets | Vault at the core, four delivery methods, SealedSecret bootstrap lane |
| Observability | Three pillars through one OTel pipe; the monitoring is itself monitored |
| Storage | Longhorn only; Retain + Prune=false + off-cluster R2 backups |
| Backstage | IDP front door — golden path templates, catalog, TechDocs |
Cross-cutting overviews: Infrastructure and Cluster health monitoring.
Showcase¶
The repository describes a live platform. Start with the Showcase to see the visual proof points: Argo CD app health, Grafana cluster health, and Hubble network visibility (Backstage and kensan views coming).
How to use this site¶
This site is the single source of truth for the current state of kensan-lab. Articles on Zenn / dev.to are point-in-time deep dives — they capture the journey but may go stale. Always cross-check against the docs here.
| If you want to… | Start here |
|---|---|
| Experience the platform locally | Try it with kind |
| Understand the platform | Architecture above, then ADRs |
| See the running system | Showcase |
| Study the bare-metal build | Bare-metal reference — not yet verified as a clean-room bootstrap |
| Operate it day-to-day | Secret Management, Runbooks |
| Read the back-stories | Articles — Zenn / dev.to deep-dive index |
| See what broke and why | Incidents |
| Feed this site to an LLM | llms.txt (curated) / llms-full.txt (full content) |
Tech Stack & Hardware¶
Tech stack table, hardware inventory, and feature highlights are in the Top README — the single source of truth.

