RKE2 Cheatsheet

RKE2 CheatsheetKapitel 07 von 11

RKE2 Upgrades

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

Zwei Wege

system-upgrade-controller (SUSE-Pattern): deklarative Plan-CRs, node-selektiert, Server zuerst, dann Agents.

Manuell: INSTALL_RKE2_VERSION setzen, Installer erneut laufen lassen, rke2-server neustarten.

Channels: INSTALL_RKE2_CHANNEL (stable | latest | v1.37). Default stable ist ein manuell gesetzter Pin und hängt hinter latest zurück (bei Redaktionsschluss v1.36.5, nicht 1.37).

Keine Minor überspringen: Ein Plan mit channel: springt direkt auf den Channel-Stand, auch über mehrere Minors, der Controller prüft das nicht. Rollback auf die alte Minor geht nur per Restore eines Snapshots, der auf dieser Minor erstellt wurde.

Agents: zweiter Plan mit prepare: {image: rancher/rke2-upgrade, args: [prepare, server-plan]}. RPM-Installation per Paketmanager aktualisieren, Rancher-verwaltete Cluster über Rancher.

apiVersion: upgrade.cattle.io/v1
kind: Plan
metadata: {name: server-plan, namespace: system-upgrade}
spec:
  concurrency: 1
  nodeSelector:
    matchExpressions:
    - {key: node-role.kubernetes.io/control-plane, operator: Exists}
  tolerations:   # sonst nie auf getainteten Servern
  - {key: CriticalAddonsOnly, operator: Exists}
  serviceAccountName: system-upgrade
  cordon: true
  upgrade: {image: rancher/rke2-upgrade}
  version: v1.37.1+rke2r1