第3章 クラスターの更新の実行

手順

1. 一時停止する利用可能なすべての MachineHealthCheck リソースをリスト表示するには、以下のコマンドを実行します。

   $ oc get machinehealthcheck -n openshift-machine-api

2. 各 MachineHealthCheck リソースに対して、次のコマンドを実行してマシンの健全性チェックを一時停止します。

   $ oc -n openshift-machine-api annotate mhc <mhc_name> cluster.x-k8s.io/paused=""

   アノテーション付きの MachineHealthCheck リソースは以下の YAML ファイルのようになります。

   apiVersion: machine.openshift.io/v1beta1
   kind: MachineHealthCheck
   metadata:
     name: example
     namespace: openshift-machine-api
     annotations:
       cluster.x-k8s.io/paused: ""
   spec:
     selector:
       matchLabels:
         role: worker
     unhealthyConditions:
     - type:    "Ready"
       status:  "Unknown"
       timeout: "300s"
     - type:    "Ready"
       status:  "False"
       timeout: "300s"
     maxUnhealthy: "40%"
   status:
     currentHealthy: 5
     expectedMachines: 5

   重要

   クラスターの更新後にマシンヘルスチェックを再開します。チェックを再開するには、以下のコマンドを実行して MachineHealthCheck リソースから pause アノテーションを削除します。

   $ oc -n openshift-machine-api annotate mhc <mhc-name> cluster.x-k8s.io/paused-

手順

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-4.22

   重要

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

   $ oc get nodes

   出力例

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