跳至主要内容

還原 Rancher

本頁面概述如何使用 Rancher 執行還原。

在以下情況下,請遵循本頁面的說明:

  • 執行中的 Rancher 執行個體與建立備份時的版本相同。
  • 上游(本機)叢集與建立備份的位置相同。
重要

在相同設定上還原 Rancher 時,operator 會在還原開始時縮減 Rancher 部署,並在還原完成後將部署擴展回來。在還原期間 Rancher 將不可用。

Fleet 使用者警告

在還原執行 Fleet 工作負載的 Rancher 設定時,你必須考慮如何處理 Kubernetes API 伺服器可用性和暫停的 GitRepos。請參閱 Fleet 文件以獲取更多詳細資訊。

提示
  • 請遵循這些步驟來遷移 Rancher。
  • 如果你需要在升級後將 Rancher 還原到先前版本,請參閱回滾文件。

建立 Restore 自訂資源​

透過建立 Restore 自訂資源來執行還原。

  1. 在左上角,點擊 ☰ > 叢集管理。

  2. 在叢集頁面上,前往 local 叢集並點擊探索。local 叢集執行 Rancher 伺服器。

  3. 在左側導覽列中,點擊 Rancher Backups > Restores。

  4. 點擊建立。

  5. 使用表單或 YAML 建立 Restore。若要使用表單建立 Restore 資源,請參閱設定參考和範例。

  6. 若要使用 YAML 編輯器,我們可以點擊 Create > Create from YAML。輸入 Restore YAML。

    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

    如需設定 Restore 的協助,請參閱設定參考和範例。

  7. 點擊建立。

結果: rancher-operator 在還原期間會縮減 rancher 部署,並在還原完成後將其擴展回來。資源按以下順序還原:

  1. 自訂資源定義 (CRDs)
  2. 叢集範圍的資源
  3. 命名空間資源

日誌​

若要檢查還原的進度,你可以檢查 operator 的日誌。執行此命令來跟蹤日誌:

kubectl logs -n cattle-resources-system -l app.kubernetes.io/name=rancher-backup -f

清理​

如果你使用 kubectl 建立了還原資源,請移除該資源以防止與未來的還原發生命名衝突。

已知問題​

在某些情況下,還原備份後,Rancher 日誌將顯示類似以下的錯誤:

2021/10/05 21:30:45 [ERROR] error syncing 'c-89d82/m-4067aa68dd78': handler rke-worker-upgrader: clusters.management.cattle.io "c-89d82" not found, requeuing

發生這種情況是因為剛還原的其中一個資源具有 finalizers,但相關資源已被刪除,因此處理程序無法找到它。

若要消除錯誤,我們需要找到並刪除導致錯誤的資源。請參閱此處以獲取更多資訊。