How livenson/talu works
Talu is a multitenant VM and managed-Kubernetes platform built on Kubernetes and KubeVirt. Users provision through Git-managed values reconciled by Flux or through Talu’s Kubernetes API: the API projects tenants, VMs, and managed clusters onto Flux HelmReleases, which render the tenancy charts onto the platform substrate. Access, observability, logging, and backup/DR are cross-cutting capabilities. The README documents these broader product branches; source excerpts show API wiring and HelmRelease projections, but not every deployment relationship.
Main entry points: kubevirt KubeVirt Compute · server.go API Group Wiring · flux Flux Reconciliation · hr.go HelmRelease Helpers
Components 23
Management
- Git Values
environments - Talu API Server
apiserver/cmd/talu-apiserver/main.go - Tenancy API Types
apiserver/pkg/apis/tenancy/v1alpha1/types.go - API Group Wiring
apiserver/pkg/server/server.go - Tenant Projection
apiserver/pkg/registry/tenant/storage.go - VM Projection
apiserver/pkg/registry/vm/storage.go - Cluster Projection
apiserver/pkg/registry/cluster/storage.go - HelmRelease Helpers
apiserver/pkg/registry/hr/hr.go - Flux Reconciliation
components/tenancy/flux
Tenant Provisioning
- Tenant Chart
components/tenancy/tenant-chart - VM Chart
components/tenancy/vm-chart - Cluster Chart
components/tenancy/cluster-chart
Compute Substrate
- Platform Services
components/infrastructure - KubeVirt Compute
components/infrastructure/kubevirt - Ceph Storage
components/infrastructure/rook-ceph
Access Plane
- Identity and Ingress
components/platform/identity - Route Portal
components/platform/portal/portal.py
Operations
- Metrics and Dashboards
components/platform/monitoring - Logs and Audit
components/platform/logging - Backup and Restore
components/platform/backup - Garage S3
Other components
- Platform User
- OIDC Provider
Connections 26
- Platform User → Git Values: commits values
README.md - Git Values → Flux Reconciliation: reconciles config
README.md - Platform User → Talu API Server: submits resources
README.md - Talu API Server → API Group Wiring: starts server
apiserver/cmd/talu-apiserver/main.go - API Group Wiring → Tenant Projection: registers storage
apiserver/pkg/server/server.go - API Group Wiring → VM Projection: registers storage
apiserver/pkg/server/server.go - API Group Wiring → Cluster Projection: registers storage
apiserver/pkg/server/server.go - API Group Wiring → Tenancy API Types: registers types
apiserver/pkg/server/server.go - Tenant Projection → HelmRelease Helpers: projects releases
apiserver/pkg/registry/tenant/storage.go - VM Projection → HelmRelease Helpers: builds releases
apiserver/pkg/registry/vm/storage.go - Cluster Projection → HelmRelease Helpers: builds releases
apiserver/pkg/registry/cluster/storage.go - HelmRelease Helpers → Flux Reconciliation: creates HelmReleases
apiserver/pkg/registry/hr/hr.go - Flux Reconciliation → Tenant Chart: renders chart
README.md - Flux Reconciliation → VM Chart: renders chart
README.md - Flux Reconciliation → Cluster Chart: renders chart
README.md - Tenant Chart → KubeVirt Compute: provisions VMs
README.md - VM Chart → KubeVirt Compute: provisions VM
README.md - Cluster Chart → KubeVirt Compute: provisions workers
README.md - KubeVirt Compute → Ceph Storage: uses storage
README.md - Platform Services → KubeVirt Compute: includes virtualization
README.md - Platform User → Identity and Ingress: authenticates
README.md - Identity and Ingress → OIDC Provider: uses OIDC
README.md - Identity and Ingress → Route Portal: exposes routes
components/platform/portal/portal.py - KubeVirt Compute → Metrics and Dashboards: exports metrics
README.md - KubeVirt Compute → Logs and Audit: provides VM logs
README.md - Backup and Restore → Garage S3: stores backups
README.md