Dieses Dokument wurde mithilfe automatisierter maschineller Übersetzungstechnologie übersetzt. Wir bemühen uns um korrekte Übersetzungen, übernehmen jedoch keine Gewähr für die Vollständigkeit, Richtigkeit oder Zuverlässigkeit der übersetzten Inhalte. Im Falle von Abweichungen ist die englische Originalversion maßgebend und stellt den verbindlichen Text dar.

Upgrade in einer Air-Gapped-Umgebung

Diese Anweisungen setzen voraus, dass Sie bereits die Anweisungen für ein Kubernetes-Upgrade auf dieser Seite befolgt haben, einschließlich der Voraussetzungen, bis Schritt 3. Rancher upgraden.

Rancher Helm Upgrade-Optionen

Um mit Helm ein Upgrade durchzuführen, wenden Sie die gleichen Optionen an, die Sie bei der Installation von Rancher verwendet haben. Verwenden Sie die Referenztabelle unten, um jeden Platzhalter zu ersetzen. Rancher muss konfiguriert werden, um das private Registry zu verwenden, um alle von Rancher gestarteten Kubernetes-Cluster oder Rancher-Tools bereitzustellen.

Basierend auf der Wahl, die Sie während der Installation getroffen haben, führen Sie eines der Verfahren unten aus.

Placeholder Beschreibung

Placeholder	Beschreibung
`<VERSION>`	Die Versionsnummer des ausgegebenen Tarballs.
`<RANCHER.YOURDOMAIN.COM>`	Der DNS-Name, den Sie auf Ihren Lastenausgleichsserver verwiesen haben.
`<REGISTRY.YOURDOMAIN.COM:PORT>`	Der DNS-Name für Ihr privates Registry.
`<CERTMANAGER_VERSION>`	Die cert-manager-Version, die im k8s-Cluster ausgeführt wird.

<VERSION>

Die Versionsnummer des ausgegebenen Tarballs.

<RANCHER.YOURDOMAIN.COM>

Der DNS-Name, den Sie auf Ihren Lastenausgleichsserver verwiesen haben.

<REGISTRY.YOURDOMAIN.COM:PORT>

Der DNS-Name für Ihr privates Registry.

<CERTMANAGER_VERSION>

Die cert-manager-Version, die im k8s-Cluster ausgeführt wird.

Option A: Standardmäßig selbstsigniertes Zertifikat

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Setzen Sie ein standardmäßiges privates Registry, das in Rancher verwendet werden soll
    --set useBundledSystemChart=true # Verwenden Sie die verpackten Rancher-Systemcharts

Behebung des 'UPGRADE FAILED'-Fehlers

Wenn Sie die Fehlermeldung Error: UPGRADE FAILED: "rancher" has no deployed releases erhalten, könnte Rancher über den helm template-Befehl installiert worden sein. Um Rancher erfolgreich zu upgraden, verwenden Sie stattdessen den folgenden Befehl:

helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
    --no-hooks \ # prevent files for Helm hooks from being generated
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Nachdem Sie den Helm-Befehl ausgeführt haben, wenden Sie die gerenderte Vorlage an:

kubectl -n cattle-system apply -R -f ./rancher

Option B: Zertifikate aus Dateien mithilfe von Kubernetes-Geheimnissen

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Wenn Sie ein von einer privaten CA signiertes Zertifikat verwenden, fügen Sie --set privateCA=true nach --set ingress.tls.source=secret hinzu:

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set privateCA=true \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Überprüfen Sie das Upgrade

Melden Sie sich bei Rancher an, um zu bestätigen, dass das Upgrade erfolgreich war.

Haben Sie nach dem Upgrade Netzwerkprobleme?

Siehe xref:[Wiederherstellung der Cluster-Netzwerkverbindung].

Bekannte Upgrade-Probleme

Eine Liste bekannter Probleme für jede Rancher-Version finden Sie in den Versionshinweisen auf GitHub und in den Rancher-Foren.