用途:验证此前生成并部署的 NVIDIA 网络部署是否正确应用,并与所选 Network Operator 版本匹配。触发场景包括“验证我的部署”“集群是否正确”“清单是否都已应用”“chart 版本是否匹配”等。使用前需阅读 ../k8s-launch-kit-shared/SKILL.md 了解安装路径、全局标志与退出码。
主要能力:检查 Network Operator Helm release 版本(读取 operator 命名空间中名称含 network-operator 的 release Secret,与 cluster-config.yaml 中 networkOperator.selectedRelease 期望版本比对);检查清单状态,将 --deployment-files 下每个 YAML 分类为 READY、IN-PROGRESS、ERROR 或 MISSING;运行连通性矩阵,默认应用生成的示例 DaemonSet,执行源绑定的 icmp、rping 和 ib_write_bw 测试,GPUDirect 启用时使用 DMA-BUF 带宽族。还会报告 deploy-preflight 漂移但不修复。
用法:l8k validate [--user-config <PATH>] [--deployment-files <DIR>] [--kubeconfig <PATH>]。常用标志包括 --skip-network-operator-helm、--validation-mode(quick/full/strict)、--validation-checks、--connectivity-timeout、--rdma-rping-iterations、--rdma-ib-write-size、--rdma-ib-write-min-bandwidth-gbps、--junit-path、--log-level。连通性模式:quick 为同 rail 节点对加非门控跨 rail 金丝雀;full 为全矩阵但跨 rail 不门控;strict 为全矩阵且跨 rail 按 profile.routing 门控。
限制:任何缺失清单、版本不匹配或门控连通性失败都会以退出码 4 结束;跳过、空或不完整的仅连通性矩阵同样退出 4。连通性需要用户自有集群配置并显式声明 profile.routing 与 validation.gpuDirect.enabled。若设置 networkOperator.skipHelmChart: true 或传入 --skip-network-operator-helm,则仅跳过 Helm 版本与 values 检查。OpenShift 校验检查 CSV 版本并创建临时命名空间,需要相应权限。其他配置细节与验收决策见 docs/user/validation.md。