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.

Aufrüstungen

Die folgenden Anweisungen führen Sie durch das Upgrade eines Rancher-Servers, der auf einem Kubernetes-Cluster mit Helm installiert wurde. Diese Schritte gelten auch für Air-Gapped-Installationen mit Helm.

Für die Anweisungen zum Upgrade von Rancher, das mit Docker installiert wurde, siehe xref:[diese Seite.]

Voraussetzungen

Zugriff auf kubeconfig

Helm sollte von demselben Ort aus ausgeführt werden wie Ihre kubeconfig-Datei oder von demselben Ort, an dem Sie Ihre kubectl-Befehle ausführen.

Wenn Sie Kubernetes mit RKE2/K3s installiert haben, wird die Kubeconfig im /etc/rancher/rke2/rke2.yaml oder /etc/rancher/k3s/k3s.yaml Verzeichnis gespeichert, abhängig von Ihrer gewählten Distribution.

Die kubeconfig kann auch manuell für den vorgesehenen Cluster mit dem --kubeconfig-Tag angesprochen werden (siehe https://helm.sh/docs/helm/helm/)).

Bekannte Probleme überprüfen

Überprüfen Sie die Liste der bekannten Probleme für jede Rancher-Version, die in den Versionshinweisen auf GitHub und in den Rancher-Foren. zu finden ist.

Helm-Version

Die Upgrade-Anweisungen setzen voraus, dass Sie Helm 3 verwenden.

Für Air-Gapped-Installationen: Private Registry befüllen

Für nur Air-Gapped-Installationen sammeln und fügen Sie Bilder für die neue Rancher-Server-Version hinzu. Befolgen Sie die Anleitung, um Ihr privates Repository mit den Bildern für die Rancher-Version, auf die Sie upgraden möchten, zu befüllen.

Für Upgrades mit cert-manager älter als 0.8.0

Let’s Encrypt wird cert-manager-Instanzen, die älter als 0.8.0 sind, ab dem 1. November 2019 blockieren. Upgrade cert-manager auf die neueste Version, indem Sie diese Anweisungen.

Upgrade-Umriss

Befolgen Sie die Schritte, um den Rancher-Server zu aktualisieren:

1. Sichern Sie Ihren Kubernetes-Cluster, der den Rancher-Server ausführt

Verwenden Sie die Backup-Anwendung, um Rancher zu sichern.

Sie verwenden die Sicherung als Wiederherstellungspunkt, falls während des Upgrades etwas schiefgeht.

2. Aktualisieren Sie das Helm-Chart-Repository

Aktualisieren Sie den lokalen Helm-Repo-Cache.
```
helm repo update
```
Holen Sie sich den Repository-Namen, den Sie zur Installation von Rancher verwendet haben.
```
helm repo list

NAME                     URL
rancher-prime          <helm-chart-repo-url>
```
Laden Sie das neueste Chart zur Installation von Rancher aus dem Helm-Chart-Repository herunter.

Dieser Befehl lädt die neuesten Charts herunter und speichert sie im aktuellen Verzeichnis als eine .tgz-Datei.
```
 helm fetch rancher-prime/rancher
```
Sie können das Chart für die spezifische Version, auf die Sie ein Upgrade durchführen, abrufen, indem Sie das --version=-Tag hinzufügen. Beispiel:
```
 helm fetch rancher-prime/rancher --version={current-patch-version}
```

3. Überprüfen Sie die Versionen der Rancher-Feature-Charts vor dem Upgrade

Rancher-Feature-Charts folgen spezifischen Release-Linien, die mit Rancher-Versionen übereinstimmen. Hauptversionen der Feature-Charts entsprechen den Minor-Versionen von Rancher und folgen einem definierten Versionsschema.

Überprüfen Sie vor dem Upgrade von Rancher alle installierten Rancher-Feature-Charts und aktualisieren Sie diese auf die neueste verfügbare Version innerhalb ihrer aktuellen Chart-Release-Linie. Dies hilft, die Kompatibilität sicherzustellen und potenzielle Probleme während oder nach dem Rancher-Upgrade zu vermeiden.

Um installierte Feature-Charts zu überprüfen:

Gehen Sie in der Rancher-Benutzeroberfläche zu Apps & Marketplace.
Wählen Sie Installierte Apps aus.
Überprüfen Sie die Chart-Versionen und aktualisieren Sie bei Bedarf auf die neueste Patch-Version innerhalb derselben Hauptversion des Charts.

Für weitere Informationen siehe das Helm Charts in Rancher – Versionierungsschema.

4. Rancher-Upgrade

In diesem Abschnitt wird beschrieben, wie Sie internetverbundene oder Air-Gapped-Installationen von Rancher mit Helm aktualisieren können.

Anweisungen für Air-Gap-Umgebungen:

Wenn Sie Rancher in einer Air-Gapped-Umgebung installieren, überspringen Sie den Rest dieser Seite und rendern Sie die Helm-Vorlage, indem Sie die Anweisungen auf dieser Seite befolgen.

Upgrade von Rancher v2.13.1

In Rancher v2.13.2 wurde der Name des Helm-Charts von rancher-prime zurück zu rancher geändert. Wenn Sie von v2.13.1 aktualisieren, gibt es einen Konflikt zwischen der bestehenden Ingress-Ressource, die vom vorherigen Chart erstellt wurde, und dem neuen, was dazu führt, dass das Upgrade mit einem ähnlichen Fehler fehlschlägt:

Error: UPGRADE FAILED: failed to create resource: admission webhook "validate.nginx.ingress.kubernetes.io" denied the request: host "rancher.my.org" and path "/" is already defined in ingress cattle-system/rancher-rancher-prime

Um dieses Problem zu verhindern oder zu lösen, müssen Sie die alte Ingress-Ressource manuell löschen, bevor Sie das Upgrade abschließen:

kubectl delete ingress rancher-rancher-prime -n cattle-system

Holen Sie sich die Werte, die mit --set übergeben wurden, aus dem aktuellen Rancher Helm-Chart, das installiert ist.

helm get values rancher -n cattle-system

hostname: rancher.my.org

Es werden weitere Werte aufgelistet, die mit diesem Befehl abgerufen werden. Dies ist nur ein Beispiel für einen der Werte.

Ihr Bereitstellungsname kann variieren; zum Beispiel, wenn Sie Rancher über den AWS Marketplace bereitstellen, lautet der Bereitstellungsname 'rancher-prime'. Somit:

helm get values rancher-prime -n cattle-system

hostname: rancher.my.org

Wenn Sie cert-manager auf die neueste Version von v1.5 oder darunter aktualisieren, folgen Sie der Dokumentation zum Upgrade von cert-manager, um zu erfahren, wie Sie cert-manager aktualisieren können, ohne Rancher deinstallieren oder neu installieren zu müssen. Andernfalls folgen Sie den Schritten zum Upgrade von Rancher unten.

Schritte zum Upgrade von Rancher

Führen Sie ein Upgrade von Rancher auf die neueste Version mit all Ihren Einstellungen durch.

Nehmen Sie alle Werte aus dem vorherigen Schritt und fügen Sie sie dem Befehl mit --set key=value hinzu.

helm upgrade rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org

Das Obige ist ein Beispiel, es können weitere Werte aus dem vorherigen Schritt vorhanden sein, die hinzugefügt werden müssen.

Wenn Sie Rancher über den AWS Marketplace bereitstellen, lautet der Bereitstellungsname 'rancher-prime'. Somit:

helm upgrade rancher-prime rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org

Alternativ ist es möglich, die aktuellen Werte in eine Datei zu exportieren und diese Datei während des Upgrades zu referenzieren. Zum Beispiel, um nur die Rancher-Version zu ändern:

Exportieren Sie die aktuellen Werte in eine Datei:

 helm get values rancher -n cattle-system -o yaml > values.yaml

Führen Sie nur ein Upgrade der Rancher-Version durch:

 helm upgrade rancher rancher-prime/rancher \
   --namespace cattle-system \
   -f values.yaml \
   --version={current-patch-version}

5. Überprüfen Sie das Upgrade

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

Bekannte Upgrade-Probleme

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