アップグレード
Red Hat OpenShift Service on AWS のアップグレードオプションについて
概要
第1章 {hcp-title} クラスターのアップグレード
ROSA コマンドラインインターフェイス (CLI) rosa
を使用して Hosted Control Plane とマシンプールを個別にアップグレードすることで、Hosted Control Plane (HCP) クラスターを使用して Red Hat OpenShift Service on AWS (ROSA) をアップグレードできます。
次のいずれかの方法を使用して、HCP クラスターをアップグレードします。
- Hosted Control Plane のみをアップグレードしてください。これはワーカーノードには影響しません。
- マシンプールのみをアップグレードします。これにより、特定のマシンプールのローリング再起動が開始されるので、特定のマシンプール上のワーカーノードに対して、一時的に影響があります。複数のマシンプールがある場合は、すべてのワーカーノードに影響があるわけではありません。
- 複数のマシンプールを同時にアップグレードします。これにより、更新されたマシンプールでワーカーノードのローリング再起動が開始します。これにより、クラスター内で複数のノードを同時に更新できます。
最初に Hosted Control Plane をアップグレードし、次にマシンプールをアップグレードします。
注記Hosted Control Plane とマシンプールの両方を同じバージョンにアップグレードする場合は、最初に Hosted Control Plane をアップグレードする必要があります。
アップグレードを計画するには、ROSA with HCP の更新ライフサイクル のドキュメントを確認してください。ライフサイクルページには、リリースの定義、サポートおよびアップグレードの要件、インストールポリシー情報、およびライフサイクルの日付が含まれます。
Hosted Control Plane のアップグレード期間はワークロード設定、マシンプールのアップグレード期間はワーカーノードの数によって異なります。
1.1. ROSA CLI を使用したアップグレード
ROSA CLI を使用して、ROSA with HCP クラスターを手動でアップグレードできます。この方法では、より新しいバージョンが利用可能な場合にクラスターを即時アップグレードするようにスケジュールします。
コントロールプレーンは、2 つの y-stream マイナーバージョン内のマシンプールのみをサポートします。たとえば、バージョン 4.15.z を使用するコントロールプレーンを備えた ROSA with HCP クラスターは、バージョン 4.13.z および 4.14.z のマシンプールをサポートしますが、バージョン 4.12.z を使用するマシンプールをサポートしません。
前提条件
- ROSA CLI の最新バージョンがインストール、設定されている。
手順
次のコマンドを実行して、クラスターの現在のバージョンを確認します。
$ rosa describe cluster --cluster=<cluster_name_or_id> 1
- 1
<cluster_name_or_id>
は、クラスター名またはクラスター ID に置き換えます。
次のコマンドを実行して、コントロールプレーンとマシンプールをアップグレードできるバージョンを一覧表示します。
コントロールプレーンのバージョンの場合は、次のコマンドを実行します。
$ rosa list upgrade --cluster=<cluster_name|cluster_id>
このコマンドは、推奨バージョンを含む、利用可能な更新のリストを返します。
出力例
VERSION NOTES 4.14.8 recommended 4.14.7 4.14.6
マシンプールのバージョンについては、次のコマンドを実行します。
$ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>
このコマンドは、推奨バージョンを含む、利用可能な更新のリストを返します。
出力例
VERSION NOTES 4.14.5 recommended 4.14.4 4.14.3 4.14.2 4.14.1
注記マシンプールで利用可能な最新の更新は、コントロールプレーンの現在のバージョンに限定されます。まずコントロールプレーンが最新であることを確認してください。
以下のオプションのいずれかでクラスターをアップグレードします。
次のコマンドを実行して、クラスターの Hosted Control Plane をアップグレードします。
$ rosa upgrade cluster -c <cluster_name> --control-plane [--schedule-date=XX --schedule-time=XX] [--version <version_number>]
Hosted Control Plane のアップグレードがスケジュールされました。
次のコマンドを実行して、クラスター上の特定のマシンプールをアップグレードします。
$ rosa upgrade machinepool -c <cluster_name> <your_machine_pool_id> [--schedule-date=XX --schedule-time=XX] [--version <version_number>]
これで、マシンプールのアップグレードがスケジュールされました。
トラブルシューティング
- スケジュールされたアップグレードが開始されない場合があります。詳細は Upgrade maintenance cancelled を参照してください。
第2章 ROSA Classic クラスターのアップグレード
2.1. ライフサイクルポリシーおよびプランニング
アップグレードを計画するには、Red Hat OpenShift Service on AWS の更新ライフサイクル を確認します。ライフサイクルページには、リリースの定義、サポートおよびアップグレードの要件、インストールポリシー情報、およびライフサイクルの日付が含まれます。
アップグレードは手動で開始されるか、自動的にスケジュールされます。Red Hat Site Reliability Engineers (SRE) はアップグレードの進捗を監視し、発生した問題に対応します。
2.2. ROSA Classic クラスターのアップグレード
Classic Red Hat OpenShift Service on AWS (ROSA) クラスターをアップグレードするには、次の 2 つの方法があります。
-
ROSA CLI (
rosa
) を介した個別のアップグレード - OpenShift Cluster Manager コンソールを使用した個別のアップグレード
スケジュールされたアップグレードポリシーに従うと、アップグレードがすぐに開始するように設定されている場合でも、アップグレードプロセスが開始するまでに 1 時間以上の遅延が発生する可能性があります。アップグレードの所要時間は、ワークロードの設定によって異なる場合もあります。
2.2.1. ROSA CLI を使用したアップグレード
ROSA CLI (rosa
) を使用して、Red Hat OpenShift Service on AWS (ROSA) クラスターを手動でアップグレードできます。
この方法では、より新しいバージョンが利用可能になると、クラスターの即時アップグレードがスケジュールされます。
前提条件
- インストールホストに、最新の ROSA CLI をインストールして設定している。
手順
クラスターの現行バージョンを確認するには、以下のコマンドを入力します。
$ rosa describe cluster --cluster=<cluster_name|cluster_id> 1
- 1
<cluster_name|cluster_id>
はクラスター名またはクラスターの ID に置き換えます。
アップグレードが利用可能であることを確認するには、以下のコマンドを入力します。
$ rosa list upgrade --cluster=<cluster_name|cluster_id>
このコマンドは、推奨されるバージョンを含め、クラスターをアップグレードすることのできるバージョンのリストを返します。
クラスターを利用可能な最新バージョンにアップグレードするには、以下のコマンドを入力します。
$ rosa upgrade cluster --cluster=<cluster_name|cluster_id>
クラスターの即時アップグレードがスケジュールされます。このアクションには、Pod の停止状態の予算などのワークロード設定に応じて、1 時間以上かかる場合があります。
アップグレードが完了するとメールが送信されます。また、ROSA CLI から
rosa description cluster
コマンドを再度実行してステータスを確認したり、OpenShift Cluster Manager コンソールでステータスを表示したりすることもできます。
トラブルシューティング
- スケジュールされたアップグレードがトリガーされない場合があります。詳細はUpgrade maintenance cancelled を参照してください。
2.2.2. OpenShift Cluster Manager コンソールを介した個別のアップグレードのスケジュール
OpenShift Cluster Manager コンソールを使用して、Red Hat OpenShift Service on AWS クラスターのアップグレードを手動で 1 回スケジュールできます。
手順
- OpenShift Cluster Manager にログインします。
- アップグレードするクラスターを選択します。
- Settings タブをクリックします。
- Update strategy ペインで、Individual Updates を選択します。
- クラスターをアップグレードするバージョンを選択します。推奨されるクラスターのアップグレードが UI に表示されます。
- 承認が必要な更新バージョンを選択した場合は、管理者承認を指定し、Approve and continue をクリックします。
Node draining ペインで、リストから猶予期間の間隔を選択します。猶予期間により、ノードは Pod のエビクションを強制する前に正常にドレイン (解放) できます。デフォルトは 1 時間 です。
注記アップグレードプロセスを開始した後は、ノードドレインの猶予期間を変更できません。
- Update strategy ペインで Save をクリックし、更新ストラテジーを適用します。
Update status ペインで、Update available 情報を確認し、Update をクリックします。
注記Update ボタンは、アップグレードが利用可能な場合に限り有効になります。
- Select version ダイアログで、ターゲットアップグレードバージョンを選択し、Next をクリックします。
Schedule update ダイアログで、クラスターのアップグレードをスケジュールします。
- 1 時間以内にアップグレードするには、Update now を選択し、Next をクリックします。
- 後でアップグレードするには、Schedule a different time を選択し、アップグレードの日時を設定します。Next をクリックして確認ダイアログに進みます。
バージョンを確認し、概要をスケジュールしたら、Confirm update を選択します。
クラスターは、ターゲットバージョンにアップグレードするようにスケジュールされます。このアクションには、選択したアップグレードのスケジュールや、Pod の停止状態の予算などのワークロード設定に応じて、1 時間以上かかる場合があります。
ステータスが Update status ペインに表示されます。
トラブルシューティング
- スケジュールされたアップグレードがトリガーされない場合があります。詳細はUpgrade maintenance cancelled を参照してください。