この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

ロールバック

このページでは、アップグレード後にRancherを以前のバージョンにロールバックする方法を説明します。

  • 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.

次の場合は、このページの指示に従ってください：

  • 実行中のRancherインスタンスは、バックアップが作成された後に新しいバージョンにアップグレードされました。

  • アップストリーム（ローカルクラスタ）は、バックアップが作成された場所と同じである。

  • これらの手順に従ってRancherを移行してください。

  • 同じRancherバージョンの以前の状態にRancherを復元する必要がある場合は、復元ドキュメントを参照してください。

Rancherを低い/以前のバージョンにロールバックするには、*Rancherバックアップ*アプリケーションを使用して、バックアップからRancherを復元します。

ロールバック後は、Rancherを低い/以前のバージョンで起動する必要があります。

復元は、復元カスタムリソースを作成することで実行されます。

特別なシナリオのための代替手順

以下のシナリオでは、ロールバックのために代替手順を実行する必要があります：

  • v2.14.0以降からv2.13.xの以前のバージョンにロールバックする。

Rancher v2.13.0では、Rancher TurtlesがCAPIリソースのデフォルトマネージャーとなり、以前の埋め込みクラスターAPIコントローラーを置き換えました。そして、Rancher v2.14.0では、埋め込みクラスターAPIが完全に削除されました。その結果、Rancher v2.14.0以降からRancher v2.13.xの以前のバージョンにロールバックし、CAPIリソースを管理するためにRancher Turtlesを引き続き使用するつもりがない場合、埋め込みクラスターAPIコントローラーを使用するために追加の手動手順が必要になる場合があります。Rancher v2.14.0以降、Rancher TurtlesはCAPIリソースの唯一のサポートされているマネージャーです。

Rancher v2.14.0では、クラスターAPIモジュールがv1.10.6からv1.12.2にアップグレードされます。クラスターAPI v1.12.2は、カスタムリソース定義（CRD）のapiVersionsを`cluster.x-k8s.io/v1beta1`から`cluster.x-k8s.io/v1beta2`にアップグレードします。Rancherのバックアップには、Cluster APIのCRDが含まれています。Rancher v2.13.xからv2.14.0にアップグレードした後、ローカルクラスタにバックアップデータを復元する際、Rancherバックアップアプリケーションは最初にv1beta1 CRDを復元します。これは、クラスター内にv1beta2カスタムリソースが存在するため、v1beta2バージョンをCRDから削除できないため失敗します。

重要:

  • バックアップ元の同じクラスターでRancherを復元するための手順は、このページの指示に従ってください。Rancherを新しいクラスターに移行するには、Rancherを移行する手順に従ってください。

  • 同じセットアップでRancherを復元する際、復元が始まる前にRancherのデプロイメントを手動でスケールダウンし、復元が完了したらオペレーターが再度スケールアップします。その結果、RancherとそのUIは復元が完了するまで利用できなくなります。UIが利用できない間は、復元YAMLファイルと共に元のクラスターのkubeconfigを使用してください：kubectl create -f restore.yaml。

手順1:復元カスタムリソースを作成する

  1. *☰ > クラスター管理*をクリックします。

  2. ローカルクラスタに移動し、*探索*をクリックします。

  3. 左側のナビゲーションバーで、Rancherバックアップ  復元をクリックします。

Rancherバックアップアプリが表示されない場合は、*アプリ*のChartsページからインストールする必要があります。詳細については、こちらを参照してください。

  1. ［作成］をクリックします。

  2. フォームまたはYAMLを使用して復元を作成します。オンラインフォームを使用して復元リソースを作成する際のヘルプについては、設定リファレンスおよび例を参照してください。

  3. YAMLエディタを使用するには、作成  YAMLから作成をクリックできます。復元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

    復元の設定に関するヘルプについては、設定リファレンスおよび例を参照してください。

  4. ［作成］をクリックします。

*結果:*バックアップファイルが作成され、ターゲットストレージの場所に更新されます。リソースは以下の順序で復元されます：

  1. カスタムリソース定義（CRD）

  2. クラスター範囲のリソース

  3. ネームスペースリソース

復元の進行状況を確認するには、オペレーターのログを確認できます。ログを取得するための手順は次のとおりです：

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

ステップ2:以前のRancherバージョンにロールバックする

RancherはHelm CLIを使用してロールバックできます。以前のバージョンにロールバックするには：

helm rollback rancher -n cattle-system

以前のリビジョンが意図したターゲットでない場合、ロールバックするリビジョンを指定できます。デプロイメントの履歴を表示するには：

helm history rancher -n cattle-system

ターゲットリビジョンが決定されたら、ロールバックを実行します。この例では、リビジョン`3`にロールバックします。

helm rollback rancher 3 -n cattle-system