用途:使用 k8s-launch-kit(l8k)发现 Kubernetes 集群的网络硬件能力,生成 cluster-config.yaml,描述 NIC、GPU、rail 和节点组。使用前需阅读 ../k8s-launch-kit-shared/SKILL.md 了解安装路径、全局标志与输出模式。
主要能力:默认使用 host 目标;发现过程会引导 NIC Configuration Daemon(必要时创建 5 个 nic-configuration-operator CRD)到私有命名空间 nvidia-k8s-launch-kit,读取 NicDevice CR,退出时拆除命名空间(除非 --keep-namespace)。无需预装 Network Operator,也不要求 Node Feature Discovery。会为节点打上 nvidia.kubernetes-launch-kit.machine 与 nvidia.kubernetes-launch-kit.gpu 标签。
用法:l8k discover --kubeconfig ~/.kube/config --save-cluster-config ./cluster-config.yaml;人类交互模式为 l8k discover --save-cluster-config <OUTPUT> [--kubeconfig <PATH>]。--save-cluster-config 必填。常用标志包括 --keep-namespace、--collapse-nic-rails(默认 true)、--user-config、--node-selector、--image-pull-secrets、--fabric、--deployment-type、--multirail、--spectrum-x、--multiplane-mode、--number-of-planes。
适用场景:需要盘点集群 NIC/GPU/rail 拓扑、为后续 l8k generate 生成清单准备配置、或在已有配置中刷新 clusterConfig 时。
限制:镜像需可从每个工作节点拉取;发现等待守护进程 Pod 就绪最多 5 分钟,部分 Pod 卡住时会继续;若报“no nodes with an NVIDIA NIC”或“no discoverable NVIDIA NICs”,分别对应无 0x15b3 设备或 BlueField 处于 restricted 模式。fabric 探测混合或未确认时 profile.fabric 为空,需显式设置。OpenShift 需传 --flavor ocp。其余细节暂未提供。