3.2.4. CLI を使用したクラスターの更新

手順

1. 以下のコマンドを実行して、利用可能な更新を確認し、適用したい更新のバージョン番号をメモします。

   $ oc adm upgrade recommend

   出力例

   The following conditions found no cause for concern in updating this cluster to later releases: recommended/CriticalAlerts (AsExpected), recommended/NodeAlerts (AsExpected), recommended/PodDisruptionBudgetAlerts (AsExpected), recommended/PodImagePullAlerts (AsExpected), recommended/UpdatePrecheckAlerts (AsExpected)
   
   Upstream update service is unset, so the cluster will use an appropriate default.
   Channel: stable-4.21 (available channels: candidate-4.20, candidate-4.21, candidate-4.22, eus-4.20, fast-4.20, fast-4.21, stable-4.20, stable-4.21)
   
   Updates to 4.21:
     VERSION     ISSUES
     4.21.14     no known issues relevant to this cluster
     4.21.13     no known issues relevant to this cluster
   And 2 older 4.21 updates you can see with '--show-outdated-releases' or '--version VERSION'.
   
   Updates to 4.20:
     VERSION     ISSUES
     4.20.20     no known issues relevant to this cluster

   注記
   • --version フラグを使用すると、特定のバージョンが更新先として推奨されているかどうかを判断できます。推奨される更新がない場合でも、既知の問題がある更新がまだ利用できる可能性があります。
   • コントロールプレーンのみ のアップデートを実行する方法は、「コントロールプレーンのみのアップデートの実行」を参照してください。

2. 組織の要件に基づいて、次のコマンドを実行して適切な更新チャネルを設定します。たとえば、チャネルを stable-4.13 または fast-4.13 に設定できます。チャネルの詳細は、「更新チャネルとリリースについて」を参照してください。

   $ oc adm upgrade channel <channel>

   コマンドの例

   $ oc adm upgrade channel stable-5.0

   重要

   実稼働クラスターの場合、stable-*、eus-* または fast-* チャネルにサブスクライブする必要があります。

   注記

   次のマイナーバージョンに移行する準備ができたら、そのマイナーバージョンに対応するチャネルを選択します。更新チャネルの宣言が早いほど、クラスターはターゲットバージョンへの更新パスをより効果的に推奨できるようになります。クラスターが利用可能なすべての更新を評価し、選択できる最適な更新の推奨事項を提供するまでに、しばらく時間がかかる場合があります。更新の推奨事項は、その時点で利用可能な更新オプションに基づいているため、時間の経過とともに変化する可能性があります。

   ターゲットマイナーバージョンへの更新パスが表示されない場合は、次のマイナーバージョンがパスで利用可能になるまで、現在のバージョンの最新のパッチリリースにクラスターを更新し続けます。

3. 更新を適用します。

   • 最新バージョンにアップデートするには、次のコマンドを実行します。

     $ oc adm upgrade --to-latest=true

   • 特定のバージョンにアップデートするには、次のコマンドを実行します。

     $ oc adm upgrade --to=<version>

     <version> は oc adm upgrade recommend コマンドの出力から取得した更新バージョンに置き換えます。

     重要

     oc adm upgrade --help コマンドを使用すると、--force フラグのオプションが表示されます。これは、強く非推奨 とされています。--force オプションを使用すると、リリースの検証や前提条件のチェックなど、クラスター側の保護機能をバイパスしてしまうためです。--force フラグを使用しても、アップデートが必ず成功するとは限りません。ガードをバイパスすると、クラスターが危険にさらされます。

4. クラスター管理者が潜在的な既知のリスクを評価し、そのリスクが現在のクラスターにおいて許容可能であると判断した場合、管理者は安全保護を解除し、次のコマンドを実行して更新を続行できます。

   $ oc adm upgrade --allow-not-recommended --to <version>

5. オプション: 次のコマンドを実行して、Cluster Version Operator のステータスを確認します。

   $ oc adm upgrade status

   注記

   更新をリアルタイムで監視するには、watch ユーティリティーで oc adm upgrade status を実行してください。

6. アップデートが完了したら、次のコマンドを実行して、クラスターのバージョンが新しいバージョンに更新されていることを確認します。

   $ oc adm upgrade

   出力例

   Cluster version is <version>
   
   Upstream is unset, so the cluster will use an appropriate default.
   Channel: stable-<version> (available channels: candidate-<version>, eus-<version>, fast-<version>, stable-<version>)
   
   No updates available. You may force an update to a specific release image, but doing so might not be supported and might result in downtime or data loss.

7. クラスターを次のマイナーバージョン (バージョン X.y から X.(y+1) など) にアップデートする場合は、新機能に依存するワークロードをデプロイする前に、ノードが更新されていることを確認します。以下のコマンドを実行します。

   $ oc get nodes

   出力例

   NAME                           STATUS   ROLES    AGE   VERSION
   ip-10-0-168-251.ec2.internal   Ready    master   82m   v1.36.3
   ip-10-0-170-223.ec2.internal   Ready    master   82m   v1.36.3
   ip-10-0-179-95.ec2.internal    Ready    worker   70m   v1.36.3
   ip-10-0-182-134.ec2.internal   Ready    worker   70m   v1.36.3
   ip-10-0-211-16.ec2.internal    Ready    master   82m   v1.36.3
   ip-10-0-250-100.ec2.internal   Ready    worker   69m   v1.36.3