アップグレード

手順

1. 次のコマンドを実行して、クラスターの現在のバージョンを確認します。

   $ rosa describe cluster --cluster=<cluster_name_or_id> 1

   1

   <cluster_name_or_id> は、クラスター名またはクラスター ID に置き換えます。

2. 次のコマンドを実行して、コントロールプレーンをアップグレードできるバージョンをリスト表示します。

   $ rosa list upgrade --cluster=<cluster_name_or_id>

   このコマンドは、推奨バージョンを含む、利用可能な更新のリストを返します。

   出力例

   VERSION  NOTES
   4.14.8   recommended
   4.14.7
   4.14.6

3. 次のコマンドを実行して、クラスターの Hosted Control Plane をアップグレードします。

   $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>

   • 指定したバージョンへの即時アップグレードをスケジュールするには、次のコマンドを実行します。

     $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane --version <version_number>

     Hosted Control Plane は即時アップグレードされる予定です。

   • 指定したバージョンへのアップグレードを将来の日付でスケジュールするには、次のコマンドを実行します。

     $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version_number>

     Hosted Control Plane は、協定世界時 (UTC) で指定された時間にアップグレードされる予定です。

手順

1. 次のコマンドを実行して、クラスターの現在のバージョンを確認します。

   $ rosa describe cluster --cluster=<cluster_name_or_id> 1

   1

   <cluster_name_or_id> は、クラスター名またはクラスター ID に置き換えます。

   出力例

   OpenShift Version:     4.14.8

2. 次のコマンドを実行して、マシンプールをアップグレードできるバージョンをリスト表示します。

   $ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>

   このコマンドは、推奨バージョンを含む、利用可能な更新のリストを返します。

   出力例

   VERSION  NOTES
   4.14.5   recommended
   4.14.4
   4.14.3

   重要

   マシンプールをコントロールプレーンよりも高いバージョンにアップグレードしないでください。より高いバージョンに移行する場合は、まずコントロールプレーンをそのバージョンにアップグレードします。

3. 次のコマンドを実行して、アップグレードするマシンプールのアップグレード動作を確認します。

   $ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>

   出力例

   Replicas: 5
   Node drain grace period:   30 minutes
   
   Management upgrade:
   - Type: Replace
   - Max surge: 20%
   - Max unavailable: 20%

   この例では、これらの設定により、マシンプールはアップグレード中に 1 つの余分なノード (replicas の 20% の max-surge) をプロビジョニングし、最大 1 つのノードを使用不可 (replicas の 20% の max-unavailable) にすることができます。したがって、このマシンプールは、レプリカ数を超えて 1 つの新しいノードをプロビジョニングし、1 つのノードを使用不可にして置き換えることで、一度に 2 つのノードをアップグレードできます。Pod 中断予算を持つワークロードを保護するために必要な場合、ノードのアップグレードは最大 30 分 (node-drain-grace-period は 30 分) 遅延されることがあります。

4. 次のコマンドを実行してマシンプールをアップグレードします。

   $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>

   アップグレードするマシンプールごとにこのコマンドを実行すると、複数のマシンプールを同時にアップグレードできます。

   • マシンプールの即時アップグレードをスケジュールするには、次のコマンドを実行します。

     $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --version <version_number>

     マシンプールは即時アップグレードするようにスケジュールされており、指定されたマシンプール内のすべてのノードのローリング置換が開始します。

   • アップグレードを将来の時刻に開始するようにスケジュールするには、次のコマンドを実行します。

     $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version_number>

     マシンプールは、協定世界時 (UTC) で指定された日時にアップグレードを開始するようにスケジュールされています。これにより、指定された時刻から、指定されたマシンプール内のすべてのノードのローリング置換が開始します。

手順

1. クラスターの現行バージョンを確認するには、以下のコマンドを入力します。

   $ rosa describe cluster --cluster=<cluster_name|cluster_id> 1

   1

   <cluster_name|cluster_id> はクラスター名またはクラスターの ID に置き換えます。

2. アップグレードが利用可能であることを確認するには、以下のコマンドを入力します。

   $ rosa list upgrade --cluster=<cluster_name|cluster_id>

   このコマンドは、推奨されるバージョンを含め、クラスターをアップグレードすることのできるバージョンのリストを返します。この推奨は、条件付き更新のリスクに基づいています。既知の各リスクは、すべてのクラスターに当てはまる場合と、特定の条件に一致するクラスターにのみ当てはまる場合があります。OpenShift リリースノートを参照して、適切なアップグレード先のバージョンを評価、検証、決定してください。

3. 1 時間以内にクラスターを指定のバージョンにすぐにアップグレードするには、次のコマンドを入力します。

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id> --version <version-id>

   注記

   AWS Security Token Service (STS) クラスターをアップグレードする場合、このコマンドによって、インタラクティブな IAM ロール/ポリシーのアップグレードモードプロセスが開始します。このプロセスでは、選択したクラスターのアカウントと Operator のロールポリシーがアップグレードのターゲットバージョンと互換性があることを確認します。選択したアップグレードバージョンとの互換性がポリシーにない場合、CLI は自動モードでポリシーを自動的にアップグレードします。

   クラスターは、Scheduled Time に示されるとおり、直ちにアップグレードされるようにスケジュールされます。アップグレードはスケジュール時刻から 1 時間以内に開始します。

4. または、将来の UTC 時刻にクラスターをアップグレードするには、次のコマンドを入力します。

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id>   \
             --version <version-id>   \
             --schedule-date yyyy-mm-dd \
             --schedule-time HH:mm

5. クラスターのアップグレード中にドレインされるすべてのノードの猶予期間をカスタマイズするには、次のコマンドを入力します。

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id>   \
             --version <version-id>   \
             --node-drain-grace-period 15 minutes

6. 次のコマンドを入力すると、アップグレードのステータスが表示されます。このコマンドでは、ステータス (scheduled または started) とスケジュール時刻の両方が表示されます。

   $ rosa list upgrade --cluster=<cluster_name|cluster_id>

   出力例

   VERSION  NOTES
   4.15.14  recommended - scheduled for 2024-06-02 15:00 UTC
   4.15.13

手順

1. 次のコマンドを使用して、クラスターの更新が開始していないことを確認します。

   $ rosa list upgrades --cluster=<cluster_name|cluster_id>

   出力例

   VERSION  NOTES
   4.15.14  recommended - scheduled for 2024-06-02 15:00 UTC
   4.15.13

2. 次のコマンドを実行して、スケジュール済みの更新を削除します。

   $ rosa delete upgrade --cluster=<cluster_name|cluster_id>

3. 確認プロンプトで Yes と入力して削除を確定します。

   出力例

   I: Successfully canceled scheduled upgrade on cluster 'my-cluster'

手順

1. OpenShift Cluster Manager にログインします。
2. アップグレードするクラスターを選択します。
3. Settings タブをクリックします。

4. Update strategy ペインで、必要な更新の種類を選択します。

   • 個別の更新の場合は、アップグレードをすぐに (1 時間以内に開始) または将来の時刻に要求できます。

   • 定期的な更新の場合は、利用可能な最新の x.y.Z (z-stream) バージョンへのアップグレードを自動的に開始する定期的な日時を選択します。

     重要

     定期的な更新は z-stream 更新にのみ適用されます。マイナーバージョンまたは y-stream の更新は手動で行う必要があります。新しい y-stream 更新が利用可能になると、通知が届きます。

5. オプション: Node draining ペインで、リストから猶予期間の間隔を選択します。猶予期間により、ノードは Pod のエビクションを強制する前に正常にドレイン (解放) できます。デフォルトは 1 時間 です。

   重要

   アップグレードプロセスを開始した後は、ノードドレインの猶予期間を変更できません。

6. Update strategy ペインで Save をクリックし、更新ストラテジーを適用します。

7. Update status ペインで、Update available 情報を確認し、Update をクリックします。

   注記

   Update ボタンは、アップグレードが利用可能な場合に限り有効になります。

8. Update cluster ダイアログが開きます。推奨されるクラスターのアップグレードが Select version ペインに表示されます。クラスターのアップグレード先のバージョンを選択し、Next をクリックします。

9. オプション: AWS Security Token Service (STS) を使用する ROSA クラスターの場合、選択したターゲットバージョンに応じて、アカウントレベルおよびクラスター固有の Operator ロールを更新する必要がある場合があります。

   1. ROSA CLI で、rosa list account-roles コマンドを実行して、アカウントロールをリスト表示し、アップグレード用に選択したターゲットマイナーバージョンとの互換性がロールにあることを確認します。ロールに互換性がない場合は、rosa upgrade account-roles コマンドを実行して、アカウントロールを最新の OpenShift バージョンにアップグレードします。
   2. ROSA CLI で、rosa list operator-roles コマンドを実行して、クラスターに関連付けられている Operator ロールをリスト表示し、アップグレード用に選択したターゲットマイナーバージョンとの互換性がロールにあることを確認します。互換性がない場合は、rosa upgrade operators-roles コマンドを実行して、クラスターの Operator ロールを最新の OpenShift バージョンにアップグレードします。
   3. 承認が必要な更新バージョンを選択した場合は、指定のフィールドに Acknowledge と入力して管理者の承認を提供し、Next をクリックします。

10. Schedule update ダイアログで、クラスターのアップグレードをスケジュールします。

    • 1 時間以内にアップグレードするには、Update now を選択し、Next をクリックします。
    • 後でアップグレードするには、Schedule a different time を選択し、アップグレードの日時を設定します。Next をクリックして確認ダイアログに進みます。
11. バージョンを確認し、概要をスケジュールしたら、Confirm update を選択します。
12. Close をクリックして、Update cluster ダイアログを終了します。

手順

1. OpenShift Cluster Manager にログインします。
2. アップグレードがスケジュールされているクラスターを選択します。
3. Settings タブをクリックします。
4. Update status ペインで、Cancel this update をクリックします。
5. Cancel update ダイアログで更新の詳細を確認し、Cancel this update をクリックします。