Skip to content

Air-gap and private-registry mirroring guide #743

Description

@mchmarny

Parent: #739
Depends on: BOM tooling issue (will link once filed)

Summary

Publish a guide for customers running AICR in air-gapped or private-registry environments that lists every public registry AICR pulls from and how to mirror them.

Motivation

AICR spans at least the following public registries across its 23 components:

  • nvcr.io — NVIDIA container registry (gpu-operator, network-operator, dynamo-platform, k8s-nim-operator, dra-driver)
  • helm.ngc.nvidia.com — NVIDIA Helm chart registry
  • ghcr.io — GitHub Container Registry (nvsentinel, nodewright, kai-scheduler, grove, kubeflow-trainer, k8s-ephemeral-storage-metrics)
  • gcr.io / gke.gcr.io / us-docker.pkg.dev — Google (gke-nccl-tcpxo)
  • public.ecr.aws / *.dkr.ecr.us-west-2.amazonaws.com — AWS (aws-ebs-csi-driver, aws-efa)
  • quay.io — Red Hat (cert-manager, prometheus components)
  • registry.k8s.io — Kubernetes SIG (nfd, prometheus-adapter, kueue, csi-sidecars)
  • cr.kgateway.dev — kgateway
  • docker.io — Docker Hub (busybox, ubuntu, pytorch in manifests)

Customers behind a corporate firewall or in true air-gapped environments need a complete list and per-component guidance.

Proposed content

docs/integrator/air-gap-deployment.md covering:

  1. Full registry list with rationale per component.
  2. Mirroring strategies — Harbor/Artifactory/JFrog patterns; how to override image.repository per component via --set or values overrides.
  3. Per-component override examples — how to point each component at a private mirror.
  4. Verification — how to confirm no images are pulled from the public internet (e.g., via NetworkPolicy or registry firewall logs).
  5. Generated image list — table sourced from the BOM tool output.

Success criteria

  • Customer can mirror all required images and deploy AICR with zero public internet pulls.
  • Page is regenerated when the BOM changes.
  • Linked from docs/integrator/.

Notes

This depends on the BOM tooling to produce the authoritative image list. Without that, the registry list above is incomplete (chart-default sub-images are not enumerated).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Fields

    No fields configured for Documentation.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions