k8s-launch-kit-validate

작성자: nvidia

Use this skill when the user wants to verify that an NVIDIA networking deployment matches the configuration that produced it. Activate for: 'is my deployment…

npx skills add https://github.com/nvidia/k8s-launch-kit --skill k8s-launch-kit-validate

ZIP 다운로드 GitHub

l8k: Validate

PREREQUISITE: Read ../k8s-launch-kit-shared/SKILL.md for install paths, global flags, and exit codes.

Verify that a previously generated and deployed NVIDIA networking deployment is correctly applied and matches the selected Network Operator release.

What it checks

Network Operator Helm release version. Reads the chart's appVersion from any release Secret named sh.helm.release.v1.<release>.v<N> whose release name contains "network-operator", in the operator namespace. Compares with the version expected by networkOperator.selectedRelease in cluster-config.yaml (looked up in l8k's embedded release catalog).
Manifest presence. Every YAML manifest under --deployment-files (skipping any file with "example" in its name) is fetched from the cluster via client.Get. Each manifest is reported FOUND, MISSING, or ERROR.
Connectivity matrix. By default, l8k validate applies the generated example DaemonSet, waits for ready pods, and runs source-bound icmp, rping, and ib_write_bw tests. The default mode is strict.

Exit code is non-zero (4) on any missing manifest, version mismatch, or gating connectivity failure. Version checks soft-skip when prerequisites are absent — no cluster-config.yaml, no Helm release Secret, etc.

Usage

l8k validate [--user-config <PATH>] [--deployment-files <DIR>] [--kubeconfig <PATH>]

Flags

Flag	Default	Description
`--kubeconfig`	`$KUBECONFIG`	Path to kubeconfig with read access to the cluster
`--user-config`	`./cluster-config.yaml`	Cluster config YAML; used for `networkOperator.selectedRelease` and the operator namespace
`--deployment-files`	`./deployment`	Directory containing the manifests to verify
`--validation-mode`	`validation.mode` (`strict`)	Connectivity mode: `quick`, `full`, or `strict`
`--validation-checks`	`validation.checks` (`icmp,rping,ib_write_bw`)	Comma-separated connectivity checks; `""` disables all
`--rdma-rping-iterations`	`validation.rdma.rpingIterations`	rping client iteration count
`--rdma-ib-write-size`	`validation.rdma.ibWriteSize`	ib_write_bw message size
`--rdma-ib-write-min-bandwidth-gbps`	`validation.rdma.ibWriteMinBandwidthGbps`	Minimum peak Gbps; `0` disables bandwidth gating

Connectivity Modes

quick: all same-rail node pairs plus one non-gating cross-rail canary per source-rail/destination-rail mapping.
full: every source rail × every destination rail × every ordered pod pair; cross-rail results are reported but do not gate pass/fail.
strict: full matrix. Cross-rail gates by profile.routing: source-based must succeed, destination-based must stay isolated.

All checks are source-bound. ICMP uses ping -I <src-iface>, rping uses -I <src-ip>, and ib_write_bw uses --bind_source_ip <src-ip>.

Examples

# Defaults: ./cluster-config.yaml + ./deployment, $KUBECONFIG
l8k validate

# Explicit paths
l8k validate --user-config ./cluster-config.yaml \
  --deployment-files ./deployment \
  --kubeconfig ~/.kube/config

# Agent mode (single JSON object on stdout, logs on stderr)
l8k validate --output json 2>/dev/null | jq '.summary'

Output

Text mode prints a short report:

Network Operator release
  selectedRelease: 26.4
  expected version: v26.4.0-beta.6
  deployed: network-operator (chart=26.4.0-beta.6 app=v26.4.0-beta.6 rev=3 status=deployed)
  result: MATCH

Manifests
  [FOUND] NicClusterPolicy/nic-cluster-policy in (cluster-scoped)
  [FOUND] NicNodePolicy/nicnodepolicy-h100 in (cluster-scoped)
  [MISSING] SriovNetwork/sriov-network-rail-0 in default — not found in cluster
  ...

Summary: 12 manifests, 1 missing/error; version: match

JSON mode (--output json) emits one object with versionCheck, manifests, and summary fields.

When this skill activates

Trigger phrases include: "validate my deployment", "is my cluster correct", "are all the manifests applied", "does the chart version match", "did the deploy succeed", or any discrepancy claim about expected vs deployed state.