Preview status and known limitations
NVIDIA Kubernetes Recipes (NVKR) is available as a preview. Commands, input schemas and behavior can change between releases, and NVKR is not recommended for production use. This page lists what the preview supports and its known limitations. The implementation and evidence record tracks the current status of each capability.
Supported at preview
- Select components, pin sources and acquired artifacts, and apply overlays: Catalogs and components.
- Generate and compare Plans, and export producer and artifact graphs: Plan and graph inspection.
- Build artifacts in a local Run: Quickstart.
- Generate a GitHub Actions workflow that builds, signs and publishes a Release: Generate a pipeline.
- Build NVKE node OS images for
amd64andarm64on a native Linux host with KVM, or in the generated workflow: Build a node image. - Browse, export, pull and verify a published Release: Browse, export, pull and verify a release.
Known limitations
Execution and publication
- GitHub is the only hosted provider. NVKR generates hosted workflows only for GitHub Actions, and only those workflows produce signed
pipeline-attestedReleases. Local walkthroughs can publish unsigned releases to a local registry. - Generated workflows use GitHub-hosted runners, except for node-image disks. Node-image disk jobs and their disk-retention finalizers run on the self-hosted
arc-amd64-kvmandarc-arm64-kvmroutes, which you provision. NVKR emits no other self-hosted runner labels. - Builds need their declared runtime. A Run needs the runtime, source access and capabilities its Definition and Environment declare. Unsupported requirements fail before execution; a declared prerequisite that is unavailable can still fail the Run partway.
- Signing and verification paths need Linux. On macOS they return a capability or platform error. macOS can build the CLI, run dry-runs, diagnostics and local Docker builds, and browse, export and pull releases. To verify from macOS, run the verifier in Docker.
Evidence and verification
- Local Runs are unsigned. A Run on your own host is in the
unqualified-local-executionevidence lane, with no signatures or build provenance. A dry-run isstatic-unqualifiedand produces no artifacts. Optional local qualification signs its evidence with your own local keys; that is local trust only and does not create apipeline-attestedRelease. - Verification covers publication, not reproduction. Verifying a Release under your policy authenticates what the hosted pipeline signed and published. It does not establish exact-byte reproduction, full disk inventory or deployment readiness.
- No NVKR Release is qualified. The
qualifiedevidence lane and full release qualification are not available at preview. Qualification checks and release-manifest issuance are implemented but not yet proven end to end. - Release browsing does not verify. Browsing a Release inspects its metadata without downloading payloads or verifying signatures. Verify under your policy before you use an artifact.
- The maintained node images’ SBOMs do not inspect the disk. The maintained GitHub Environments select the producer-only
build-provenance-v1disk-evidence mode. Its signed SBOM records each disk’s exact producer and material subjects, with disk inspection markednot-performed, and does not establish what is installed on the disk. Strict disk inventory is deferred. See Dependency SBOMs.
Node images
- FDE node images make no confidentiality claim. The full-disk encryption (FDE) variants use a public bootstrap passphrase. First boot binds the existing volume key to the TPM without re-encrypting, so the source audit concludes that nodes built from one image keep that image’s volume key. Use FDE images for evaluation only, and do not rely on them for data-at-rest confidentiality. A recorded development Run built, signed and published the
amd64andarm64FDE images; TPM first-boot behavior and a complete Release containing them are not yet established.