RKE2 Cheatsheet

RKE2 CheatsheetKapitel 08 von 11

RKE2 Air-Gap

Stand RKE2 1.37 · Edition 2026.11 · Release-Daten geprüft am 30. Oktober 2026

Images & Binary

Images-Tarball (rke2-images.linux-amd64.tar.zst = Core + Canal) nach /var/lib/rancher/rke2/agent/images/ legen, RKE2 importiert ihn beim Start in containerd. Andere CNIs: rke2-images-core plus CNI-Bundle (rke2-images-cilium, -calico, -flannel), Multus zusätzlich -multus.

Binary + install.sh offline via INSTALL_RKE2_ARTIFACT_PATH.

Seit 1.36 enthält rke2-images-core Traefik statt nginx. Wer nginx weiter betreibt, spiegelt zusätzlich rke2-images-ingress-nginx.

touch agent/images/.cache.json: Re-Import nur noch bei geänderter Datei. Für Upgrades per Plan zusätzlich rancher/rke2-upgrade, rancher/system-upgrade-controller und rancher/kubectl spiegeln.

Private Registry

/etc/rancher/rke2/registries.yaml: Mirror-Endpunkte + Auth + TLS, auf jedem Node, wirksam nach Neustart, für System-Images und Workloads. Kein Rückfall auf den Upstream bei gespiegelten Registries (je Node): disable-default-registry-endpoint: true.

# /etc/rancher/rke2/registries.yaml
mirrors:
  docker.io:
    endpoint:
      - "https://registry.internal:5000"
configs:
  registry.internal:5000:
    auth: {username: robot, password: <token>}
    tls: {ca_file: /etc/ssl/registry-ca.pem}