[转载] 在 Kubernetes 上运行 AI/ML 工作负载：用于 Kubeflow 的 Headlamp 插件
本文为授权转载，非本账号原创。
原文：在 Kubernetes 上运行 AI/ML 工作负载：用于 Kubeflow 的 Headlamp 插件（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/）
原作者及译者：借由 Alok Dangre (independent) | 译者 Xin Li (DaoCloud) | 2026.07.13
来源：Kubernetes 官方中文博客；许可：CC BY 4.0（参考地址：https://creativecommons.org/licenses/by/4.0/）。保留原作者和译者署名，正文仅做适配博客编辑器的排版与链接格式转换，未改写技术内容。
内容不代表原作者或 Kubernetes 项目对本账号的认可或背书。
Kubernetes 已经悄然成为 AI 和机器学习的默认平台。 无论你是为数据科学家运行 Notebook 服务器、调度分布式训练作业、调优超参数， 还是编排多步骤 ML 流水线，这些工作负载越来越多地运行在 Kubernetes 集群上。 Kubeflow（参考地址：https://www.kubeflow.org/） 是组装该堆栈最流行的方式之一，它以 Kubernetes 原生方式实现：每个功能都作为自定义资源定义（CRD）暴露。
这种设计对集群管理员来说是一个礼物，因为这意味着 ML 工作负载可以使用与集群中其他所有东西相同的原语进行观察和管理。
但实际上，这些平台附带的专业 ML 仪表板隐藏了底层的 Kubernetes 层。
当 Notebook 卡住或训练运行失败时，管理员通常不得不回到 kubectl 来找出 Pod 级别实际发生了什么。
本文介绍了 Headlamp Kubeflow 插件，它通过在通用 Kubernetes UI 中直接展示 Kubeflow 的自定义资源来弥合这一问题。 这是任何 CRD 密集型平台都可以遵循的模式的一个实例：在管理员已经工作的地方与他们会面，并向他们展示集群级别的真相。
Headlamp 本身是一个可扩展的 Kubernetes Web UI，由 Kubernetes SIG UI（参考地址：https://github.com/kubernetes-sigs/headlamp） 维护，采用 Apache 2.0 许可。 它可以作为桌面应用或在集群内运行，其插件系统允许任何人添加自定义资源的一流视图。
为什么管理员需要不同的视图（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e4%b8%ba%e4%bb%80%e4%b9%88%e7%ae%a1%e7%90%86%e5%91%98%e9%9c%80%e8%a6%81%e4%b8%8d%e5%90%8c%e7%9a%84%e8%a7%86%e5%9b%be）
专门构建的 ML 仪表板帮助数据科学家提交实验、流水线和 Notebook。 集群管理员和站点可靠性工程师（SRE）对底层的 Kubernetes 资源进行故障排除，他们会问不同的问题：
- 为什么 Notebook 卡住了？是
ImagePullBackOff、OOMKilled，还是 Pod 在等待 PersistentVolumeClaim？ - 最近跨命名空间有哪些 Run 资源失败了？
- Katib Experiment 报告哪个参数集是最优的？
- TrainJob 资源是否引用了预期的 TrainingRuntime 资源？
- 哪些批处理工作负载正在运行，Kubernetes 报告什么状态？
Headlamp Kubeflow 插件通过直接从 Kubernetes API 服务器读取数据来帮助回答这些问题。 它显示 Pod 状况、Kubernetes 失败原因以及跨命名空间的资源，无需中间的 ML 服务或数据库。
插件涵盖的内容（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e6%8f%92%e4%bb%b6%e6%b6%b5%e7%9b%96%e7%9a%84%e5%86%85%e5%ae%b9）
Kubeflow 是模块化的，团队通常只安装他们需要的组件。 插件会发现集群上的 Kubeflow API 组，并只显示相应的部分。
插件支持以下组件系列和 API 资源：
Headlamp 插件支持的 Kubeflow 组件和 API 资源| 组件 | 用途 | API 资源 |
|---|---|---|
| Notebook | 提供 Jupyter、VS Code 和 RStudio 等开发环境 | Notebook、Profile、PodDefault |
| Pipeline | 定义和跟踪流水线、版本、实验、运行和调度 | Pipeline、PipelineVersion、Run、RecurringRun、Experiment |
| Katib | 自动化超参数调优和神经架构搜索 | Experiment、Trial、Suggestion |
| Training | 运行 PyTorch 和 TensorFlow 作业等分布式训练工作负载 | TrainJob、TrainingRuntime、ClusterTrainingRuntime |
| Spark | 使用 Apache Spark 运行大规模数据处理 | SparkApplication、ScheduledSparkApplication |
你可以看到什么（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e4%bd%a0%e5%8f%af%e4%bb%a5%e7%9c%8b%e5%88%b0%e4%bb%80%e4%b9%88）
检查 Notebook Pod（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e6%a3%80%e6%9f%a5-notebook-pod）
Notebook 详情视图显示 Pod 条件及其 reason 和 message 字段。
它还显示 CPU、内存和 GPU 的请求和限制；卷挂载及其后端类型，如 PersistentVolumeClaim、ConfigMap、Secret
或 emptyDir；引用 Secret 或 ConfigMap 对象的环境变量；边车容器；以及节点容忍度。
这个视图整合了否则需要多个 kubectl describe 命令才能获得的信息。
检查超参数调优（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e6%a3%80%e6%9f%a5%e8%b6%85%e5%8f%82%e6%95%b0%e8%b0%83%e4%bc%98）
Katib 视图显示调优算法、搜索空间、每个 Trial 及其实时状态，以及当前最佳 Trial 及其指标值和参数分配。 它们还显示早停配置和提前停止的 Trial 资源数量，因此你可以在不离开集群 UI 的情况下跟踪搜索过程。
无需后端数据库检查流水线状态（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e6%97%a0%e9%9c%80%e5%90%8e%e7%ab%af%e6%95%b0%e6%8d%ae%e5%ba%93%e6%a3%80%e6%9f%a5%e6%b5%81%e6%b0%b4%e7%ba%bf%e7%8a%b6%e6%80%81）
Pipeline 视图直接读取 Kubernetes API 资源，不查询 Kubeflow Pipeline API 服务或后端数据库。
即使该服务不可用，你也可以检查存储的流水线状态。
Pipeline 详情视图以并排 YAML diff 方式比较最新和之前的 PipelineVersion 规约。
Run 视图显示状态和持续时间，RecurringRun 视图显示人类可读的调度，Artifact 视图汇总最近 Run 资源的 pipelineRoot 值。
映射 ML 资源（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e6%98%a0%e5%b0%84-ml-%e8%b5%84%e6%ba%90）
插件注册了一个 Headlamp 映射资源（参考地址：https://headlamp.dev/docs/latest/development/plugins/functionality/extending-the-map/），
将 Notebook、Profile、PodDefault、Experiment、Pipeline、SparkApplication 和 TrainJob 资源渲染为图节点。
它根据 .metadata.ownerReferences 在支持的资源之间绘制边。
当你悬停在这些资源类型上时，Headlamp 还会显示内联摘要。
试试看（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e8%af%95%e8%af%95%e7%9c%8b）
Kubeflow 插件 README（参考地址：https://github.com/headlamp-k8s/plugins/blob/main/kubeflow/README.md） 解释了安装和本地集群设置，包括用于评估的轻量级仅 CRD 路径。 由于插件会发现已安装的 API 组，你可以将其与现有的模块化 Kubeflow 安装一起使用， 或创建一个仅包含 CRD 和示例资源的评估集群。
将模式应用到其他平台（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/introducing-headlamp-plugin-for-kubeflow/#%e5%b0%86%e6%a8%a1%e5%bc%8f%e5%ba%94%e7%94%a8%e5%88%b0%e5%85%b6%e4%bb%96%e5%b9%b3%e5%8f%b0）
Kubeflow 展示了一个更广泛的模式。平台通常使用自定义资源对特定领域的工作流进行建模。 它们的仪表板专注于这些工作流，而 Kubernetes 管理员也需要底层 API 资源和 Pod 的状态。 通用 Kubernetes UI 中的 CRD 驱动插件可以暴露该状态，而无需管理员在不相关的工具之间切换。
该插件使用 Apache 2.0 许可，由 Kubernetes SIG UI 开发。 要报告问题或贡献改进，请使用 Headlamp 插件仓库的 Issue Tracker（参考地址：https://github.com/headlamp-k8s/plugins/issues） 或 Pull Request（参考地址：https://github.com/headlamp-k8s/plugins/pulls）。
- ←上一页（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/13/kubernetes-dashboard-to-headlamp/）
- 下一页→（参考地址：https://kubernetes.io/zh-cn/blog/2026/07/14/custom-metrics-exporter-kubernetes/）
- 点赞
- 收藏
- 关注作者
评论（0）