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.

Rollbacks

Diese Seite beschreibt, wie man Rancher nach einem Upgrade auf eine frühere Version zurücksetzt.

  • This is only possible by restoring to a previous version from a backup instance. Changing versions using kubectl or Helm is not supported.

  • When rolling back, ensure the version being restored is under active support. Rolling back to versions that are end-of-life is not supported. Refer to SUSE’s Product Support Lifecycle page to verify key lifecycle dates for your given version.

Befolgen Sie die Anweisungen auf dieser Seite, wenn:

  • Die laufende Rancher-Instanz wurde nach der Erstellung der Sicherung auf eine neuere Version aktualisiert.

  • Der Upstream (lokaler) Cluster ist derselbe wie der, auf dem die Sicherung erstellt wurde.

Um Rancher auf eine niedrigere/frühere Version zurückzusetzen, verwenden Sie die Rancher Backups Anwendung und stellen Sie Rancher aus der Sicherung wieder her.

Rancher muss nach einem Rollback mit der niedrigeren/früheren Version gestartet werden.

Eine Wiederherstellung erfolgt durch die Erstellung einer benutzerdefinierten Ressource für die Wiederherstellung.

Alternative Schritte für spezielle Szenarien

Alternative Schritte müssen für Rollbacks in den folgenden Szenarien durchgeführt werden:

  • Rollback von v2.14.0 und später auf eine frühere Version von v2.13.x.

In Rancher v2.13.0 wurden Rancher Turtles zum Standardmanager für CAPI-Ressourcen und ersetzten die zuvor eingebetteten Cluster-API-Controller. In Rancher v2.14.0 wurde die eingebettete Cluster-API vollständig entfernt. Wenn Sie also von Rancher v2.14.0 und später auf eine frühere Version von Rancher v2.13.x zurückrollen und nicht beabsichtigen, Rancher Turtles weiterhin zur Verwaltung von CAPI-Ressourcen zu verwenden, sind möglicherweise zusätzliche manuelle Schritte erforderlich, um die eingebetteten Cluster-API-Controller zu verwenden. Ab Rancher v2.14.0 ist Rancher Turtles der einzige unterstützte Manager für CAPI-Ressourcen.

In Rancher v2.14.0 wird das Cluster-API-Modul von v1.10.6 auf v1.12.2 aktualisiert. Das Cluster-API v1.12.2 aktualisiert seinerseits die apiVersions seiner benutzerdefinierten Ressourcenbeschreibungen (CRDs) von cluster.x-k8s.io/v1beta1 auf cluster.x-k8s.io/v1beta2. Rancher-Sicherungsdateien enthalten Cluster-API-CRDs. Beim Wiederherstellen von Sicherungsdaten von Rancher v2.13.x auf einen lokalen Cluster nach dem Upgrade auf v2.14.0 stellt die Rancher Backups-Anwendung zuerst die v1beta1-CRDs wieder her. Dies schlägt fehl, da die v1beta2-Version nicht von den CRDs entfernt werden kann, solange v1beta2 benutzerdefinierte Ressourcen im Cluster vorhanden sind.

Wichtig:

  • Befolgen Sie die Anweisungen auf dieser Seite, um Rancher im selben Cluster wiederherzustellen, von dem es gesichert wurde. Um Rancher in einen neuen Cluster zu migrieren, befolgen Sie die Schritte, um Rancher zu migrieren.

  • Beim Wiederherstellen von Rancher im selben Setup wird die Rancher-Implementierung manuell heruntergefahren, bevor die Wiederherstellung beginnt. Anschließend wird der Operator sie wieder hochfahren, sobald die Wiederherstellung abgeschlossen ist. Infolgedessen sind Rancher und seine Benutzeroberfläche nicht verfügbar, bis die Wiederherstellung abgeschlossen ist. Während die Benutzeroberfläche nicht verfügbar ist, verwenden Sie die ursprüngliche Cluster-Kubeconfig mit der Wiederherstellungs-YAML-Datei: kubectl create -f restore.yaml.

Schritt 1: Erstellen Sie die benutzerdefinierte Ressource 'Restore'.

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Gehen Sie zum lokalen Cluster und klicken Sie auf Erkunden.

  3. Klicken Sie in der linken Navigationsleiste auf Rancher Backups  Wiederherstellen.

Wenn die Rancher Backups-App nicht sichtbar ist, müssen Sie sie von der Charts-Seite in Apps installieren. Weitere Informationen finden Sie hier.

  1. Klicken Sie auf Erstellen.

  2. Erstellen Sie das Restore über das Formular oder per YAML. Für Hilfe bei der Erstellung der Restore-Ressource über das Online-Formular, siehe die Konfigurationsreferenz und die Beispiele.

  3. Um den YAML-Editor zu verwenden, können Sie auf Erstellen  Aus YAML erstellen. klicken. Geben Sie das Restore-YAML ein. Das folgende Beispiel zeigt eine Restore-Custom-Ressource:

     apiVersion: resources.cattle.io/v1
 kind: Restore
 metadata:
   name: restore-migration
 spec:
   backupFilename: backup-b0450532-cee1-4aa1-a881-f5f48a007b1c-2020-09-15T07-27-09Z.tar.gz
   encryptionConfigSecretName: encryptionconfig
   storageLocation:
     s3:
       credentialSecretName: s3-creds
       credentialSecretNamespace: default
       bucketName: rancher-backups
       folder: rancher
       region: us-west-2
       endpoint: s3.us-west-2.amazonaws.com

    Für Hilfe bei der Konfiguration des Restore, siehe die Konfigurationsreferenz und die Beispiele.

  4. Klicken Sie auf Erstellen.

Ergebnis: Die Sicherungsdatei wird erstellt und im Zielspeicherort aktualisiert. Die Ressourcen werden in dieser Reihenfolge wiederhergestellt:

  1. Benutzerdefinierte Ressourcenbeschreibungen (CRDs)

  2. Cluster-spezifische Ressourcen

  3. Namensraum-spezifische Ressourcen

Um zu überprüfen, wie die Wiederherstellung voranschreitet, können Sie die Protokolle des Operators überprüfen. Führen Sie die folgenden Schritte aus, um die Protokolle zu erhalten:

kubectl get pods -n cattle-resources-system
kubectl logs -n cattle-resources-system -f

2. Schritt: Auf eine frühere Rancher-Version zurücksetzen

Rancher kann mit der Helm-Kommandozeilenschnittstelle zurückgesetzt werden. Um auf die vorherige Version zurückzusetzen:

helm rollback rancher -n cattle-system

Wenn die vorherige Revision nicht das beabsichtigte Ziel ist, können Sie eine Revision angeben, auf die zurückgesetzt werden soll. Um die Implementierungshistorie anzuzeigen:

helm history rancher -n cattle-system

Wenn die Zielrevision bestimmt ist, führen Sie das Rollback durch. Dieses Beispiel wird auf die Revision 3 zurückrollen:

helm rollback rancher 3 -n cattle-system