NVIDIA / holodeck / 21071867024

push

github

feat: add Kubernetes installation from custom sources

Implements support for building and installing Kubernetes from git
repositories and tracking latest branches, enabling users to test
bleeding-edge versions and custom K8s builds.

New API Features:
- Added `source` field to Kubernetes spec (release|git|latest)
- Added K8sGitSpec for specifying git repos and refs
- Added K8sLatestSpec for tracking latest commits on branches
- Maintains backward compatibility with existing `kubernetesVersion` field
- API validation enforces source-specific constraints

Provisioning Support:
- kubeadm installer: Builds K8s binaries from source
  * Extracts Go version from go.mod and installs toolchain
  * Builds kubeadm, kubelet, kubectl
  * Handles Go module cache permissions
  * Installs Calico CNI
- KIND installer: Builds custom node images from source
  * Automatically installs kubectl for cluster verification
  * Installs docker buildx for image builds
  * Supports git refs and latest branch tracking
- Automatic Docker version upgrade for KIND source builds
  * Ensures Docker API v1.44+ compatibility
  * Only applies to KIND with git/latest sources
  * Transparent to users

Provenance Tracking:
- Records installation metadata in /etc/kubernetes/PROVENANCE.json
- Includes source, repo, ref, commit, version, installer, timestamp

Testing:
- 16 API validation tests
- 5 template generation tests
- 5 Docker auto-upgrade tests
- 3 E2E tests (2 passing, 1 blocked by infrastructure)

Documentation:
- Comprehensive design doc (831 lines)
- Implementation plan with step-by-step guide
- Example configurations

Related changes:
- Cleanup: Remove completed AMI-to-OS mapping prompt
- Add docs/prompts/README.md for prompt organization

Signed-off-by: Carlos Eduardo Arango Gutierrez <eduardoa@nvidia.com>

132 of 196 new or added lines in 5 files covered. (67.35%)

1795 of 3281 relevant lines covered (54.71%)

0.61 hits per line