Skip to content

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

Platform Architecture Platform Architecture

Everything inside the cards runs in-cluster — click to enlarge

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.

License

Apache-2.0