Platform Administration¶
For the people who run kMetal: installing the platform on an under cluster, configuring it, onboarding tenants, and keeping it healthy.
If you are here to create clusters and run workloads in an Environment someone else gave you, you want the Tenant Guide instead.
Installation¶
Under Cluster — prepare the bare-metal cluster kMetal installs onto: requirements, the primary CNI, storage, registry access.
Install kMetal — install the operator and the KMetal object that describes the platform.
Platform Validation — confirm every component reconciled before handing the platform to anyone.
Configuration¶
Platform Configuration — the KMetal spec: what it covers, and what the release pins instead.
Component Configuration — the escape hatches for individual components.
Configuration Best Practices — what to decide before the first install, and what is expensive to change later.
Per-subsystem: Networking · Storage · Tenant Storage (CSI) · Load Balancer · Control Plane External Access · VM Images
Tasks¶
Task-oriented guides grouped by capability — Tasks.
Onboarding a tenant, assigning quotas, giving a tenant its own provider network, choosing which cluster shapes and Kubernetes versions are on offer, building the OS artifacts machines boot from, setting up backups, and delivering add-ons across the fleet.
Tenancy¶
Onboarding a tenant means creating the Tenant, then an Environment with its network — the walkthrough is in Getting Started.
Multi-Tenancy — the isolation model: what separates one tenant from another, and where the boundaries are.
RBAC — who may do what, on the under cluster and inside tenant clusters.
Security¶
Operations¶
Monitoring — what to watch, and what a healthy platform looks like.
Upgrades — moving the platform to a new kMetal release.
Node Upgrades — moving the under cluster's own Kubernetes version, as a resource rather than a runbook.
Backup & Recovery · Disaster Recovery — protecting platform state and getting it back.
Scaling · Maintenance · Stretched Clusters
When something breaks¶
Troubleshooting — installs that do not converge, components that misbehave, the under-cluster network.
Looking something up¶
Reference — every KMetal field, the operator chart values, and the CLI.