docs(readme): address review feedback on Standalone, AI Conformant version, Free tier, vNode framing, and Links section #3904
+23
−22
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -22,19 +22,19 @@ | |
| | ||
| <a href="https://github.com/cncf/k8s-ai-conformance/tree/main/v1.35/vcluster-private-nodes"><img src="https://raw.githubusercontent.com/cncf/artwork/main/projects/kubernetes/certified-kubernetes-ai/versionless/color/CNCF_AI_Conformance_Logo-Color-V2.png" alt="Kubernetes AI Conformant" height="100"></a> | ||
|
|
||
| **CNCF Certified Kubernetes — Distribution** · **Kubernetes AI Conformant** | ||
|
|
||
| </div> | ||
|
|
||
| --- | ||
|
|
||
| ## What is vCluster? | ||
|
|
||
| **vCluster** creates **Tenant Clusters** — fully isolated Kubernetes environments that run on top of a Control Plane Cluster or standalone on dedicated infrastructure or bare metal. Each tenant gets its own API server, CRDs, and RBAC, with a cluster experience indistinguishable from a dedicated Kubernetes cluster. | ||
|
|
||
| Built for production. Trusted in production. **40M+ Tenant Clusters deployed** by teams at Adobe, CoreWeave, NVIDIA, Lintasarta, Atlan, Deloitte, and hundreds of AI clouds, AI factories, and Fortune 500 platform organizations. | ||
|
|
||
| **[CNCF Certified Kubernetes — Distribution](https://www.cncf.io/training/certification/software-conformance/)** and **[Kubernetes AI Conformant](https://github.com/cncf/k8s-ai-conformance/tree/main/v1.35/vcluster-private-nodes)** — every Tenant Cluster is upstream Kubernetes with no vendor lock‑in, validated for portable AI/ML workloads (training, inference, agentic). | ||
|
|
||
| > **The public-cloud experience, on your own infrastructure.** Give every team the Kubernetes they need — with strict isolation, hardware-aware scheduling, and zero tenant sprawl — whether you run one region or 100K GPUs. | ||
|
|
||
|
|
@@ -59,7 +59,7 @@ vcluster create my-vcluster --namespace team-x | |
| kubectl get namespaces | ||
| ``` | ||
|
|
||
| **Prerequisites:** A running Kubernetes cluster and `kubectl` configured. | ||
|
|
||
| 👉 **[Full Quickstart Guide](https://www.vcluster.com/docs/get-started)** | ||
|
|
||
|
|
@@ -78,19 +78,20 @@ kubectl get namespaces | |
|
|
||
| ### 🎁 vCluster Free Tier | ||
|
|
||
| Real usage, not a gated demo. Unlimited Tenant Clusters up to 64 CPUs / 32 GPUs, plus the full vCluster Platform UI — for free. **[Get Started Free →](https://www.vcluster.com/free)** | ||
|
|
||
| --- | ||
|
|
||
| ## 🆕 What's New | ||
|
|
||
| | Version | Feature | Description | | ||
| |---------|---------|-------------| | ||
| | **v0.34** | [Multi-Region Platform & Standalone Snapshots](https://www.vcluster.com/releases/changelog/vcluster-platform-v49-vcluster-v034-multi-region-platform-snapshot-support) | Active/active vCluster Platform across regions (Route 53 + RDS), Standalone snapshots (S3 / OCI / local), first-class template parameters | | ||
| | **v0.33** | [Enterprise Reliability & Storage](https://github.com/loft-sh/vcluster/releases/tag/v0.33.0) | Automatic leaf-cert regeneration, Azure Blob snapshot destinations, workload-level sleep annotations | | ||
| | **v0.32** | [Docker Driver & DRA](https://github.com/loft-sh/vcluster/releases/tag/v0.32.0) | Run vCluster on Docker, Dynamic Resource Allocation (DRA) for GPU workloads, in-place pod resizing | | ||
| | **v0.31** | [Snapshots & Cross-Cluster APIs](https://github.com/loft-sh/vcluster/releases/tag/v0.31.0) | Expanded snapshot/restore lifecycle, PDBs for Tenant Cluster control planes, cross-cluster resource proxying | | ||
| | **v0.30** | [vCluster VPN & Netris Integration](https://www.vcluster.com/releases/en/changelog/platform-v45-and-vcluster-v030-secure-cloud-bursting-on-prem) | Tailscale-powered overlay networking and automated hardware isolation via Netris | | ||
| | **v0.27–v0.29** | [Architecture Foundations](https://www.vcluster.com/docs/vcluster/introduction/architecture/) | [Private Nodes](https://www.vcluster.com/docs/vcluster/deploy/worker-nodes/private-nodes) (v0.27, CNI/CSI isolation), [Auto Nodes](https://www.vcluster.com/docs/vcluster/deploy/worker-nodes/private-nodes/auto-nodes/) (v0.28, Karpenter autoscaling), [Standalone Mode](https://www.vcluster.com/docs/vcluster/deploy/control-plane/binary/) (v0.29, no Control Plane Cluster — dedicated infrastructure or bare metal) | | ||
|
|
||
| 👉 **[Full Changelog](https://www.vcluster.com/releases)** | ||
|
|
||
|
|
@@ -111,7 +112,7 @@ Real usage, not a gated demo. Unlimited Tenant Clusters up to 64 CPUs / 32 GPUs, | |
|
|
||
| ## 🏗️ Architectures | ||
|
|
||
| vCluster supports multiple deployment architectures. Each builds on the previous, offering progressively stronger isolation — from dense shared infrastructure to fully standalone deployments on dedicated infrastructure or bare metal. | ||
|
|
||
| ### Architecture Comparison | ||
|
|
||
|
|
@@ -214,14 +215,16 @@ privateNodes: | |
| | Feature | Description | | ||
| |---------|-------------| | ||
| | **🎛️ Isolated Virtual Control Plane** | Each Tenant Cluster gets its own API server, controller manager, and data store — complete Kubernetes API isolation | | ||
| | **🔗 Shared Platform Stack** *(Shared / Dedicated Nodes)* | Leverage the Control Plane Cluster's CNI, CSI, ingress, and other infrastructure — no duplicate platform components | | ||
| | **🔒 Strong Tenant Isolation** | Tenants get admin access inside their Tenant Cluster while having minimal permissions on the Control Plane Cluster | | ||
|
There was a problem hiding this comment. This isn't quite right because control plane cluster modes with private nodes wouldn't support this.
Contributor
Author
There was a problem hiding this comment. Same fix in 3b62b19 — qualifier on Resource Syncing is now |
||
| | **🔄 Resource Syncing** *(Shared / Dedicated Nodes)* | Bidirectional sync of any Kubernetes resource — pods, services, secrets, configmaps, CRDs, and more | | ||
| | **💤 Sleep Mode** | Pause inactive Tenant Clusters to save resources. Instant wake when needed | | ||
|
There was a problem hiding this comment. This isn't quite right because control plane cluster modes with private nodes wouldn't support this.
Contributor
Author
There was a problem hiding this comment. Fixed in 3b62b19 — Integrations note now says "host-side integrations apply in Shared / Dedicated Nodes modes," and the footnote below the table now reads:\n\n> Shared Platform Stack, Resource Syncing, and host-cluster integrations apply only in Shared and Dedicated Nodes modes, where the Tenant Cluster shares the Control Plane Cluster's CNI, CSI, and platform stack. Private Nodes and Standalone deployments bring their own CNI, CSI, and platform components. |
||
| | **🖥️ Standalone Deployment** | Run without a Control Plane Cluster on dedicated infrastructure or bare metal — purpose-built for AI factories and on-prem GPU fleets | | ||
| | **🧩 Integrations** | Native support for cert-manager, external-secrets, KubeVirt, Istio, and metrics-server (host-side integrations apply in Shared / Dedicated Nodes modes) | | ||
| | **📊 High Availability** | Multiple replicas with leader election. Embedded etcd or external databases (PostgreSQL, MySQL, RDS) | | ||
|
|
||
| > *Shared Platform Stack, Resource Syncing, and host-cluster integrations apply only in **Shared** and **Dedicated Nodes** modes, where the Tenant Cluster shares the Control Plane Cluster's CNI, CSI, and platform stack. **Private Nodes** and **Standalone** deployments bring their own CNI, CSI, and platform components.* | ||
|
|
||
| --- | ||
|
|
||
| ## 🌐 The vCluster Platform | ||
|
|
@@ -231,11 +234,11 @@ vCluster is the foundation of a broader platform for running production Kubernet | |
| | Product | What it does | | ||
| |---------|--------------| | ||
| | **[vCluster](https://www.vcluster.com)** | Tenant Clusters — Virtual Control Planes with API, data, and (optionally) network isolation | | ||
| | **[vNode](https://www.vnode.com/)** | Runtime-level isolation. Kernel-enforced boundaries (seccomp, cgroups, namespaces, AppArmor) without VM overhead | | ||
| | **[vMetal](https://www.vmetal.ai/)** | Zero-touch bare metal provisioning for GPU fleets. Turns GPU racks into a cloud platform | | ||
| | **[Netris](https://www.vcluster.com/solutions/netris-kubernetes-network-automation)** *(integration)* | Hardware-enforced network isolation via programmatic VLANs, VRFs, and ACLs | | ||
|
|
||
| Together these provide a complete foundation for AI factories — certified Kubernetes stacks, isolated Tenant Clusters, runtime workload sandboxing, and GPU infrastructure operations — the same pattern used to run production AI on hundreds of AI clouds and Fortune 500 on-prem platforms. | ||
|
|
||
| --- | ||
|
|
||
|
|
@@ -314,16 +317,14 @@ We welcome contributions! Check out our **[Contributing Guide](https://github.co | |
|
|
||
| --- | ||
|
|
||
| ## 🤝 Connect with us | ||
|
|
||
| - 💬 Join our [Slack community](https://slack.loft.sh/) — 5K+ engineers | ||
| - 💼 Follow on [LinkedIn](https://www.linkedin.com/company/vcluster) — 28K+ | ||
| - 🐦 Follow on [X](https://x.com/vcluster) — 3.7K+ | ||
| - 📺 Watch on [YouTube](https://www.youtube.com/@vcluster) | ||
| - 📝 Read the [Blog](https://loft.sh/blog) | ||
| - 📅 Book a [consultation](https://start-chat.com/slack/Loft-Labs/NnQl1M) | ||
|
|
||
| --- | ||
|
|
||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This isn't quite right because control plane cluster modes with private nodes wouldn't support this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Right, sorry — fixed in 3b62b19. Qualifier is now
(Shared / Dedicated Nodes). Private Nodes have their own CNI/CSI per the Architecture Comparison table above so they don't share the host stack.