NVIDIA 开源 NVKE 预览版，在自有 GPU 基础设施上运行托管 Kubernetes

在您自己的 NVIDIA GPU 基础设施上运行托管 Kubernetes 服务。 NVIDIA Kubernetes® Engine (NVKE) 提供管理平面，平台团队安装该平面后即可为其客户创建和运营 Kubernetes 集群。每个工作负载集群都有其自己的 Kubernetes 控制平面、etcd 和节点池。您运营 NVKE 管理平面；您的客户通过 Kubernetes API 和 kubectl 使用他们的集群。

预览版：NVKE 以预览版形式提供。API、配置和行为可能在不同版本之间发生变化，我们不建议将 NVKE 用于生产工作负载。请参阅预览状态和已知限制。

开始使用 · 文档 · 参与贡献 · 获取帮助

开始使用

您的目标	从这里开始	您将获得
无需 GPU 硬件即可评估	本地快速入门	在模拟机器上运行开发管理平面和工作负载集群。无需 NVIDIA 账户。
在您的基础设施上安装	规划您的安装	准备节点、引导管理集群并安装其服务的前提条件和步骤。
构建或贡献	从源代码构建	NVKE 二进制文件和贡献者开发循环。

本地快速入门运行在 Linux 主机或虚拟机，amd64 或 arm64 上，至少需要 6 个 CPU、12 GiB 可用内存和 100 GiB 可用磁盘。它需要 Docker、虚拟 TPM 支持以及指南中列出的工具。按照其设置完成工作负载集群创建，并确认集群的节点报告 Ready。在 macOS 上，请使用本地站点指南，该指南在 Colima 虚拟机内运行评估。

对于真实安装，您需要提供机器、网络、节点镜像和镜像仓库，并配置对 NVIDIA Infra Controller (NICo) 的访问。NICo 是预览阶段唯一兼容的基础设施提供程序。平台和版本参考列出了经过验证的组合和固定依赖项。

NVKE 的功能

创建独立的工作负载集群。通过 NVKE API 或 nvkectl 请求集群；NVKE 通过 NICo 配置机器，并组建具有各自控制平面的 Kubernetes 集群。
管理工作负载集群生命周期。创建、扩缩和删除节点池，升级 Kubernetes 并替换节点。有关替换和升级的手动步骤及预览限制，请参阅节点池指南。
建立节点身份。节点在获得加入凭据之前，使用其 TPM 通过 SPIFFE/SPIRE 进行证明。etcd 数据加密可按集群启用。
将构建与部署连接起来。其配套项目 NVIDIA Kubernetes Recipes (NVKR) 从固定输入构建节点镜像和 NVKE 组件。NVKE 部署这些工件；NVKR 负责其构建和发布证据。

预览版需要显式配置操作员：安装后 API 认证处于关闭状态，且 API 使用明文 HTTP。在允许调用方接入之前，请先配置 API 认证与受保护访问。管理集群不会自行升级、扩缩容或替换自身，也没有管理平面升级或备份/恢复流程。FDE 节点镜像仅供评估使用，不提供静态数据机密性。在选择评估或安装路径之前，请阅读已知限制。

概述

该图展示了 NVKE 产品家族、它如何构建在 NICo 和你的 GPU 机器之上，以及哪些组件之间相互通信。

NVKE 不是 Kubernetes 发行版，也不是 Cluster API 的一种实现。它是一个 Kubernetes 集群的自托管工厂：一个一次性的种子集群启动一个管理集群，随后其上的管理平面按需创建并生命周期管理多个隔离的工作负载集群。

一次安装包含两类 Kubernetes 集群：

管理集群运行 NVKE 管理平面和基础设施控制器。nvkectl 使用一个临时种子集群来构建它；安装管理平面服务是单独的步骤。
工作负载集群运行客户应用。管理平面通过 NICo、Cluster API 和节点代理来创建和操作它们。

阅读什么是 NVKE 了解操作员工作流，阅读架构了解实现与数据流。

从源码构建

使用 Go 1.27.3（go.work 中固定的版本）以及 GNU Make 4 或更高版本。首次构建时必须能够访问公共 Go 模块。Flox 是可选的，用于提供仓库的开发工具；在 macOS 上，它还提供 GNU Make 4。工具链设置请参见开发。

git clone https://github.com/dsx-ai-factory/nvke.git
cd nvke
make build

这会构建工作区并将九个二进制文件写入 bin/：agent、 updater、controller、nvkectl、capd-reboot-controller、 nvke-os-image-check、management-engine、tenant-api 和 operator-api。构建不会启动管理平面或创建集群。节点代理运行在 Linux 上。

工作区指南解释了各模块和输出。本地服务和测试环境请参见本地开发环境搭建。提交变更之前，请遵循 CONTRIBUTING.md 并运行 make preflight；它会针对你修改过的模块选择相应的检查。

文档

任务	指南
准备节点并引导管理集群	引导管理集群
安装 NVKE 服务	从部署路径安装管理平面
构建节点镜像并提供发布产物	从 NVKR 获取 NVKE 产物
创建和管理客户集群	创建工作负载集群、管理节点池
授予客户访问权限	访问工作负载集群
检查集群健康状况和遥测数据	观测 NVKE 及其集群

文档索引链接了其余指南和参考资料。

贡献与支持

欢迎贡献、缺陷报告和文档改进。请从 CONTRIBUTING.md 开始；在进行较大规模工作之前先提交 issue，以便维护者就方案达成一致。

问题：GitHub Discussions。
聊天：DSX AI Factory Slack 中的 #nvke 频道。获取邀请。
缺陷与功能请求：GitHub Issues。
安全漏洞：请遵循 SECURITY.md 并私下报告。
社区：行为准则、治理、维护者和支持。
发布：发布流程。
CI 健康度：CI 仪表板显示每个工作流最近三十次运行情况，并每小时刷新一次。

商标

Kubernetes® 是 The Linux Foundation 在美国及其他国家的注册商标。NVIDIA 和 NVIDIA 徽标是 NVIDIA Corporation 在美国及其他国家的商标和/或注册商标。其他公司和产品名称可能是与其相关联的各自公司的商标。

许可证

Apache License 2.0。参见 LICENSE 和 NOTICE。