📄️ Overview & Architecture
What This Add-On Does
📄️ Prerequisites & Values
Required Cluster Components
📄️ Pre-flight Checks
Run every check below before applying any manifest. Each check has an expected output and a remediation if the result differs.
📄️ Namespace & PriorityClass
Create the Overprovisioning Namespace
📄️ Placeholder Deployment
The placeholder Deployment keeps "warm" pods running on pre-provisioned nodes. It also pre-pulls the SageMaker Distribution image onto each warm node using an initContainer, so the image is already cached by the time a real Workspace lands.
📄️ Cluster Proportional Autoscaler
For clusters that grow and shrink significantly, a static replica count for placeholder pods is either insufficient (bursts stall) or wasteful (idle overhead during quiet periods). The Kubernetes Cluster Proportional Autoscaler (CPA) watches the node count and scales the placeholder Deployment proportionally.
📄️ NodePool & Disruption
This page covers the Karpenter side of the pattern. If you already have a working NodePool and HyperpodNodeClass dedicated to Spaces, review the disruption settings below and skip the rest.
📄️ Verification
Run these checks in order. They confirm the warm pool is healthy, that Workspaces land on warm nodes via both scheduling paths (coexist and preempt), and that Karpenter provisions replacement nodes correctly.
📄️ Operations & Observability
Day-2 reference. Use the Quick Reference table below to find the right command for the change you want to make; each row links to the detailed subsection.
📄️ Rollback & Troubleshooting
Rollback / Uninstall