docs(kubernetes): dedicated Kubernetes docs hub

[sam-goodwin]

Kubernetes gets its own docs hub. The thesis: one workload model for any cluster — Deployment, Job, Manifest, HelmChart point at a kubeconfig context, a raw connection, or a managed cluster, and the cluster's adapter decides what comes for free (auth only, or auth + workload identity + image registry on EKS).

/kubernetes
├─ Overview · Setup
├─ Tutorial    part 1–4 on a local cluster (image:, Job/CronJob, Manifests, Helm), part 5 moves the same program to EKS
├─ Clusters    connecting · local clusters · Amazon EKS
├─ Workloads   deployments · jobs · image sources · bindings · pod template
├─ Objects     manifests · helm charts
├─ Guides      exposing services · how apply works · writing a cluster adapter
└─ Resources   generated reference

• New Kubernetes tab (docs-tabs.ts), sidebar group, and reference-directory card; /providers/kubernetes/* now belong to the hub tab instead of the bare Reference tab.
• aws/compute/eks keeps cluster provisioning (Network, Cluster, AccessEntry, Addon, HyperPod) and hands workloads off to the hub; choosing-a-runtime and the AWS index link the hub.
• examples/kubernetes-local: the tutorial's end state on any kubeconfig cluster, no registry needed.

Tutorial parts 1–4 were run end to end on a kind cluster. Two provider bugs surfaced and are fixed here:

 // Kubernetes/internal/client.ts — deleteObject
-        path,
+        // batch/v1 Jobs default to Orphan propagation, leaving pods behind
+        path: `${path}?propagationPolicy=Background`,

 // Kubernetes/HelmChart.ts — default releaseName
-    return createPhysicalName({ id, lowercase: true });
+    return createPhysicalName({ id, lowercase: true, maxLength: 53 });

Before the second fix, a stack named KubernetesLocalExample failed helm template with release name … must not be longer than 53.

🤖 Generated with Claude Code