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

手順

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

   $ oc get machinehealthcheck -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

2. マシンヘルスチェックを一時停止するには、cluster.x-k8s.io/paused="" アノテーションを MachineHealthCheck リソースに追加します。以下のコマンドを実行します。

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

   Copy to Clipboard Toggle word wrap

   アノテーション付きの 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

   Copy to Clipboard Toggle word wrap
   重要

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

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

   Copy to Clipboard Toggle word wrap

手順

1. 利用可能な更新を確認し、適用する必要のある更新のバージョン番号をメモします。

   $ oc adm upgrade recommend

   Copy to Clipboard Toggle word wrap

   出力例

   Failing=True:
   
     Reason: ClusterOperatorNotAvailable
     Message: Cluster operator monitoring is not available
   ...
   Upstream update service: https://api.integration.openshift.com/api/upgrades_info/graph
   Channel: candidate-4.16 (available channels: candidate-4.16, candidate-4.17, candidate-4.18, eus-4.16, fast-4.16, fast-4.17, stable-4.16, stable-4.17)
   
   Updates to 4.16:
     VERSION     ISSUES
     4.16.32     no known issues relevant to this cluster
     4.16.30     no known issues relevant to this cluster
   And 2 older 4.16 updates you can see with '--show-outdated-releases' or '--version VERSION'.

   Copy to Clipboard Toggle word wrap

   注記
   • --version フラグを使用すると、特定のバージョンが更新先として推奨されているかどうかを判断できます。推奨される更新がない場合でも、既知の問題がある更新がまだ利用できる可能性があります。
   • Control Plane Only の更新を実行する方法の詳細情報は、関連情報セクションに記載されている コントロールプレーンのみの更新を実行するための準備 ページを参照してください。

2. 組織の要件に基づいて、適切な更新チャネルを設定します。たとえば、チャネルを stable-4.13 または fast-4.13 に設定できます。チャネルの詳細は、追加リソースセクションにリストされている 更新チャネルとリリースについて を参照してください。

   $ oc adm upgrade channel <channel>

   Copy to Clipboard Toggle word wrap

   たとえば、チャネルを stable-4.20 に設定するには、以下を実行します。

   $ oc adm upgrade channel stable-4.20

   Copy to Clipboard Toggle word wrap
   重要

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

   注記

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

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

3. 更新を適用します。

   • 最新バージョンに更新するには、以下を実行します。

     $ oc adm upgrade --to-latest=true 

     1

     Copy to Clipboard Toggle word wrap

   • 特定のバージョンに更新するには、以下を実行します。

     $ oc adm upgrade --to=<version> 

     1

     Copy to Clipboard Toggle word wrap

     1 1

     <version> は、oc adm upgrade recommend コマンドの出力から取得した更新バージョンです。

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

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

        Copy to Clipboard Toggle word wrap
        重要

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

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

   $ oc adm upgrade status

   Copy to Clipboard Toggle word wrap
   注記

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

5. 更新が完了したら、クラスターのバージョンが新たなバージョンに更新されていることを確認できます。

   $ oc adm upgrade

   Copy to Clipboard Toggle word wrap

   出力例

   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.

   Copy to Clipboard Toggle word wrap

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

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap