NVKE：裸金属上的 GPU Kubernetes 管理平面
本文目录
NVIDIA Kubernetes Engine（NVKE）#
在你自己的 NVIDIA GPU 基础设施上运行托管 Kubernetes 服务。
NVIDIA Kubernetes® Engine（NVKE）提供平台团队安装后用来为客户创建和运营 Kubernetes 集群的管理平面（management plane）。每个工作负载集群（workload cluster）都有自己的 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 的一种 flavour。它是一个用于 Kubernetes 集群的自托管工厂：一个一次性的种子集群（seed cluster）会启动一个管理集群，然后管理集群上的管理平面按需配置并生命周期管理许多隔离的工作负载集群。
一次安装中有两类 Kubernetes 集群：
- 管理集群运行 NVKE 管理平面和基础设施控制器。nvkectl 使用一个临时种子集群来组建它；安装管理平面服务是单独的步骤。
- 工作负载集群运行客户应用。管理平面通过 NICo、Cluster API 和节点代理（node agent）创建和运营它们。
请阅读《什么是 NVKE》了解运维人员工作流，阅读《架构》了解实现和数据流。
从源码构建#
使用 go.work 中固定的 Go 1.27.3，以及 GNU Make 4 或更高版本。首次构建时必须能访问公共 Go 模块。Flox 是可选的，提供仓库的开发工具；在 macOS 上，它还提供 GNU Make 4。工具链设置见 Development。
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 私下报告。
社区：Code of Conduct、Governance、Maintainers 和 Support。
发布：发布流程。
CI 健康状况：CI 仪表板显示每个工作流最近三十次运行，每小时刷新一次。
商标#
Kubernetes® 是 Linux 基金会在美国和其他国家的注册商标。NVIDIA 和 NVIDIA 标志是 NVIDIA Corporation 在美国和其他国家的商标和/或注册商标。其他公司和产品名称可能是与其相关联的公司各自的商标。
许可证#
Apache License 2.0。见 LICENSE 和 NOTICE。
Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
关于#
NVIDIA Kubernetes Engine（NVKE）。面向裸金属 GPU Kubernetes 的管理平面。
docs.nvidia.com/nvke/
主题：bare-metal、cluster-api、gpu、kubernetes、nvidia
资源：Readme、Apache-2.0 license、Code of conduct、Contributing、Security policy