|
この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。 |
アップグレード
以下の手順は、Helmを使用してKubernetesクラスターにインストールされたRancherサーバーのアップグレードを案内します。これらの手順は、Helmを使用したエアギャップ環境でのインストールにも適用されます。
DockerでインストールされたRancherのアップグレード手順については、xref:[このページ]を参照してください。
前提条件
kubeconfigへのアクセス
Helmは、kubeconfigファイルと同じ場所、またはkubectlコマンドを実行する場所から実行する必要があります。
RKE2/K3sでKubernetesをインストールした場合、Kubeconfigは選択したディストリビューションに応じて`/etc/rancher/rke2/rke2.yaml`または`/etc/rancher/k3s/k3s.yaml`ディレクトリに保存されます。
kubeconfigは、`--kubeconfig`タグを使用して対象のクラスターに手動で指定することもできます（参照: https://helm.sh/docs/helm/helm/)）
既知の問題の確認
各Rancherバージョンの既知の問題のリストを確認してください。これは、 GitHubのリリースノートや Rancherフォーラムで見つけることができます。
エアギャップ環境でのインストールの場合:プライベートレジストリに投入します
エアギャップ環境でのインストールのみ、新しいRancherサーバーバージョン用のイメージを収集・配置してください。ガイドに従い、プライベートレジストリにイメージを展開し、アップグレード対象のRancherバージョンのイメージを用意してください。
0.8.0より古いcert-managerを使用したアップグレードの場合
Let’s Encryptは、2019年11月1日から0.8.0より古いcert-managerインスタンスをブロックします。 cert-managerを最新バージョンにアップグレードするには、これらの手順に従ってください。
アップグレードの概要
Rancherサーバーをアップグレードする手順に従ってください:
1.Rancherサーバーが稼働しているKubernetesクラスターのバックアップを取ってください。
バックアップアプリケーションを使用してRancherをバックアップします。
アップグレード中に何か問題が発生した場合、バックアップを復元ポイントとして使用します。
2.Helmチャートリポジトリを更新します。
-
ローカルのHelmリポジトリキャッシュを更新します。
helm repo update
-
Rancherをインストールするために使用したリポジトリ名を取得します。
helm repo list NAME URL rancher-prime <helm-chart-repo-url>
-
HelmチャートリポジトリからRancherをインストールするための最新のチャートを取得します。
このコマンドは最新のチャートをダウンロードし、現在のディレクトリに`.tgz`ファイルとして保存します。
helm fetch rancher-prime/rancherアップグレードする特定のバージョンのチャートを取得するには、`--version=`タグを追加します。 次に例を示します。
helm fetch rancher-prime/rancher --version={current-patch-version}
3.アップグレード前にRancherの機能チャートバージョンを確認します。
Rancherの機能チャートは、Rancherのバージョンに合わせた特定のリリースラインに従います。機能チャートの主要バージョンはRancherのマイナーバージョンに対応し、定義されたバージョニングスキームに従います。
Rancherをアップグレードする前に、インストールされているRancherの機能チャートを確認し、現在のチャートリリースライン内で最新の利用可能なバージョンにアップグレードします。これにより互換性が確保され、Rancherのアップグレード中または後に潜在的な問題を回避できます。
インストールされた機能チャートを確認するには：
-
RancherのUIで、アプリとマーケットプレイスに移動します。
-
インストール済みアプリを選択します。
-
チャートのバージョンを確認し、必要に応じて同じチャートの主要バージョン内で最新のパッチリリースにアップグレードします。
詳細については、Helm Charts in Rancher – Versioning Schemeを参照してください。
4.Rancherをアップグレードします。
このセクションでは、通常の（インターネット接続）またはエアギャップ環境でのインストールのRancherをHelmでアップグレードする方法について説明します。
|
エアギャップの手順：
エアギャップ環境にRancherをインストールする場合は、このページの残りの部分をスキップし、このページの指示に従ってHelmテンプレートをレンダリングしてください。 |
|
Rancher v2.13.1からのアップグレード
Rancher v2.13.2では、Helmチャート名が`rancher-prime`から`rancher`に戻りました。v2.13.1からアップグレードする場合、以前のチャートによって作成された既存のIngressリソースが新しいものと競合し、次のようなエラーでアップグレードが失敗します： この問題を防ぐか解決するためには、アップグレードを完了する前に古いIngressを手動で削除する必要があります： |
現在インストールされているRancher Helmチャートから、`--set`で渡された値を取得します。
helm get values rancher -n cattle-system hostname: rancher.my.org
|
このコマンドでリストされる値がさらにあります。これは、値の一例です。 |
|
デプロイメント名は異なる場合があります。たとえば、AWS Marketplaceを通じてRancherをデプロイする場合、デプロイメント名は’rancher-prime’です。 したがって： helm get values rancher-prime -n cattle-system hostname: rancher.my.org |
v1.5以下から最新バージョンにcert-managerをアップグレードする場合は、cert-managerアップグレードドキュメントに従って、Rancherのアンインストールや再インストールを行わずにcert-managerをアップグレードする方法を学んでください。そうでない場合は、以下のRancherをアップグレードする手順に従ってください。
Rancherをアップグレードする手順
すべての設定を保持したまま、Rancherを最新バージョンにアップグレードします。
前のステップからすべての値を取得し、`--set key=value`を使用してコマンドに追加します。
helm upgrade rancher rancher-prime/rancher \ --namespace cattle-system \ --set hostname=rancher.my.org
|
上記は一例であり、前のステップから追加する必要がある値がさらにあるかもしれません。 |
|
AWS Marketplaceを通じてRancherをデプロイする場合、デプロイメント名は’rancher-prime’です。 したがって： helm upgrade rancher-prime rancher-prime/rancher \ --namespace cattle-system \ --set hostname=rancher.my.org |
また、現在の値をファイルにエクスポートし、アップグレード中にそのファイルを参照することも可能です。たとえば、Rancherのバージョンのみを変更するには：
-
現在の値をファイルにエクスポートします:
helm get values rancher -n cattle-system -o yaml > values.yaml
-
Rancherのバージョンのみを更新します:
helm upgrade rancher rancher-prime/rancher \ --namespace cattle-system \ -f values.yaml \ --version={current-patch-version}
既知のアップグレードの問題
各Rancherバージョンの既知の問題のリストは、 GitHubのリリースノートおよび Rancherフォーラムで確認できます。