Skip to main content
Version: v0.36 Stable

AI Cloud: Managed Kubernetes Service

Run a managed Kubernetes service on your GPU infrastructure. Each customer gets an isolated tenant cluster with dedicated GPU nodes. Your product is what customers interact with. Platform is the operations layer your team runs behind it.

Customer access model: External paying customers, no direct Platform access. Worker-node model: Private nodes per customer. See Choose a worker node model.

Typical stack: Standalone (HA) as the control plane cluster. Private nodes per customer cluster. vMetal for bare metal GPU lifecycle. vNode for workload runtime isolation.

Enterprise AI platform architecture: central control plane that creates tenant clusters for customers
Central control plane managing tenant clusters for customers

What makes this path different: Customers never access Platform directly. They interact with your product. Platform RBAC locks direct access to your platform engineering team. This architecture also maps to the cluster-level isolation criteria that AI cloud buyers evaluate in frameworks like ClusterMAX.

If your customers buy managed model endpoints instead of Kubernetes clusters, start with Inference Provider: Managed Model Serving. That path uses the same GPU infrastructure building blocks, but the customer-facing product boundary is an inference API and endpoint lifecycle instead of a tenant Kubernetes API.

Day 0: Design decisions​

DecisionRead nextOutcome
Choose the control plane deployment modelStandalone deployment, ArchitectureControl planes as pods on an existing Kubernetes cluster, or Standalone on dedicated CPU nodes. Standalone is the common choice when no prior Kubernetes substrate exists.
Plan bare metal GPU provisioningvMetal docs, Metal3 node provider, bare metal overviewDecide whether vMetal manages the full machine lifecycle (PXE, OS imaging, BMC, reclaim) or nodes are joined manually or using another provisioner.
Define per-customer node isolationPrivate Nodes, node requirementsEach customer's tenant cluster gets its own dedicated GPU node pool with a separate CNI/CSI, eliminating interference between customers.
Plan network isolationVPN, Netris integrationTenant clusters connect to their private nodes over an encrypted VPN tunnel. Netris integration adds switch-level VLAN/VXLAN isolation per tenant.
Define the default network policy postureNetwork policySet a default-deny east-west posture per tenant template and confirm the control plane cluster's CNI enforces it. Some CNIs accept NetworkPolicy objects without enforcing them.
Choose runtime isolation modelvNode docs, Virtual NodesvNode provides kernel-level container isolation without VM overhead. Recommended when customers run privileged workloads, dynamic code execution, or need GPU access using CDI.
Choose the GPU scheduling modelDeviceClasses, DRA ResourceClaimsDevice-plugin-style DeviceClass sync covers simple, whole-GPU allocation. DRA ResourceClaim sync (Pro) supports fine-grained and shared GPU allocation.
Plan tenant storageStorage classes from host, CSI storage capacitiesDecide which storage classes each tenant tier can request (etcd/control-plane storage vs. model weights and checkpoints), and whether to sync host CSIStorageCapacity for scheduler-aware placement.
Define cluster templates and AI stacksTemplates, Certified StacksEach customer cluster template includes GPU Operator, a scheduler (Run.ai, Kueue, Volcano), and optionally a developer environment. Certified Stacks provide pre-validated configurations.
Decide whether to sell inference endpointsInference Provider, Inference serving stacksIf your product abstracts Kubernetes away and exposes model endpoints, use the inference provider path for endpoint templates, serving stack deployment, routing, and autoscaling.
Plan the customer-facing provisioning APIProduct control plane on the Platform API, Projects, QuotasYour product API calls Platform to provision tenant clusters. Define the project structure, quota model, and automation hooks that back your customer-facing workflows.
Plan durabilityBacking store, container control plane HA, Standalone HA, Platform HAChoose the data store and replica model for Platform and per-customer control planes.
Plan security hardening and audit loggingSecurity baseline, CIS hardening guide, Platform audit loggingApply a CIS benchmark baseline to the control plane cluster and decide audit log retention and SIEM integration before onboarding tenants.

Day 1: Stand up the first production customer cluster​

note

Steps 3 and 4 configure Platform for your platform engineering team, not for your customers. Customers provision clusters through your product. Platform access should be restricted to your ops team.

  1. Install vCluster Platform. If building from bare metal, deploy vCluster Standalone first, then move to Standalone HA before production traffic.
  2. Configure backing store and Platform HA.
  3. Configure SSO and permissions for your platform engineering team.
  4. Create projects, templates, quotas, and Auto Nodes to back your customer provisioning workflows.
  5. Set up vMetal and the Metal3 node provider: register BMC credentials, configure PXE networking, define OS images, and verify bare metal hosts reach available.
  6. Configure per-customer network isolation with VPN and, if using Netris, the Netris integration. Apply a default-deny network policy per customer template and confirm the control plane cluster's CNI enforces it.
  7. Configure per-tier storage classes and, if the scheduler needs capacity-aware placement, sync CSI storage capacities.
  8. Configure GPU scheduling: sync DeviceClasses for device-plugin allocation, or enable DRA ResourceClaim sync for fine-grained allocation.
  9. Apply the CIS hardening baseline to the control plane cluster and enable Platform audit logging.
  10. Install vNode on eligible GPU nodes. Configure sync.toHost.pods.runtimeClassName: vnode in the cluster template.
  11. Deploy the first customer template using Certified Stacks as the starting point for GPU Operator, scheduler, and AI tooling.
  12. Validate tenant isolation from inside the tenant cluster: confirm the customer cannot see the control plane cluster, other tenants, or platform internals.
  13. Wire your product API to Platform's provisioning endpoints and test the end-to-end customer onboarding flow.

Day 2: Operate​

OperationRead next
Manage bare metal capacity and machine lifecycleBare metal overview, Metal3 node provider, vMetal docs
Monitor platform and tenant workloadsMonitoring overview, fleet monitoring
Operate managed inference endpointsInference Provider, Inference serving stacks, GPU and inference autoscaling
Upgrade Platform and tenant clustersUpgrade vCluster, Upgrade Platform
Back up and restore tenant clusters and PlatformSnapshots, Restore, Platform backup
Manage vNode compatibility during upgradesvNode limitations, vNode configuration
Scale the control plane clusterPlatform HA, multi-region Platform
Track GPU utilization and faults for metering and troubleshootingGPU observability templates, NVSentinel GPU observability
Review audit logs and security posturePlatform audit logging, security baseline