15.3. Lifecycle Agent を使用したシングルノード OpenShift クラスターのイメージベースアップグレードの実行

手順

1. ImageBasedUpgrade CR にパッチが適用されていることを確認します。

   apiVersion: lca.openshift.io/v1
   kind: ImageBasedUpgrade
   metadata:
     name: upgrade
   spec:
     stage: Idle
     seedImageRef:
       version: 4.15.2 1
       image: <seed_container_image> 2
       pullSecretRef: <seed_pull_secret> 3
     autoRollbackOnFailure: {}
   #    initMonitorTimeoutSeconds: 1800 4
     extraManifests: 5
     - name: example-extra-manifests-cm
       namespace: openshift-lifecycle-agent
     - name: example-catalogsources-cm
       namespace: openshift-lifecycle-agent
     oadpContent: 6
     - name: oadp-cm-example
       namespace: openshift-adp

   1

   ターゲットプラットフォームのバージョンを指定します。値はシードイメージのバージョンと一致する必要があります。

   2

   ターゲットクラスターがシードイメージをプルできるリポジトリーを指定します。

   3

   イメージがプライベートレジストリー内にある場合は、コンテナーイメージをプルするための認証情報を含むシークレットへの参照を指定します。

   4

   (オプション) 最初の再起動後、指定された時間枠内にアップグレードが完了しない場合にロールバックする時間枠を秒単位で指定します。定義されていないか 0 に設定されている場合は、デフォルト値の 1800 秒 (30 分) が使用されます。

   5

   (オプション) アップグレード後に保持するカスタムカタログソースと、シードイメージの一部ではないターゲットクラスターに適用する追加のマニフェストを含む ConfigMap リソースのリストを指定します。

   6

   OADP ConfigMap 情報を含む oadpContent セクションを追加します。

2. Prep ステージを開始するには、次のコマンドを実行して、ImageBasedUpgrade CR の stage フィールドの値を Prep に変更します。

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Prep"}}' --type=merge -n openshift-lifecycle-agent

   OADP リソースと追加のマニフェストの ConfigMap オブジェクトを指定すると、Lifecycle Agent は Prep ステージで指定された ConfigMap オブジェクトを検証します。以下の問題が発生する可能性があります。

   • Lifecycle Agent が extraManifests パラメーターに問題を検出した場合の検証警告またはエラー。
   • Lifecycle Agent が oadpContent パラメーターに問題を検出した場合の検証エラー。

   検証警告は Upgrade ステージをブロックしませんが、アップグレードを続行しても安全かどうかを判断する必要があります。これらの警告 (CRD の欠落、namespace の欠落、またはドライランの失敗など) は、警告に関する詳細で Prep ステージの status.conditions と ImageBasedUpgrade CR の annotation フィールドを更新します。

   検証警告の例

   [...]
   metadata:
   annotations:
     extra-manifest.lca.openshift.io/validation-warning: '...'
   [...]

   ただし、MachineConfig または Operator マニフェストを追加マニフェストに追加するなどの検証エラーが発生すると、Prep ステージが失敗し、Upgrade ステージがブロックされます。

   検証に合格すると、クラスターは新しい ostree stateroot を作成します。これには、シードイメージのプルと展開、およびホストレベルのコマンドの実行が含まれます。最後に、必要なすべてのイメージがターゲットクラスターに事前キャッシュされます。

手順

1. Upgrade ステージに移動するには、次のコマンドを実行して、ImageBasedUpgrade CR の stage フィールドの値を Upgrade に変更します。

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Upgrade"}}' --type=merge

2. 次のコマンドを実行して、ImageBasedUpgrade CR のステータスを確認します。

   $ oc get ibu -o yaml

   出力例

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: |-
         Waiting for system to stabilize: one or more health checks failed
           - one or more ClusterOperators not yet ready: authentication
           - one or more MachineConfigPools not yet ready: master
           - one or more ClusterServiceVersions not yet ready: sriov-fec.v2.8.0
       observedGeneration: 1
       reason: InProgress
       status: "True"
       type: UpgradeInProgress
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-05-19T14:01:52Z"
     validNextStages:
     - Rollback

   OADP Operator は、OADP Backup および Restore CR で指定されたデータのバックアップを作成し、ターゲットクラスターが再起動します。

3. 次のコマンドを実行して、CR のステータスを監視します。

   $ oc get ibu -o yaml

4. 正常にアップグレードされたら、次のコマンドを実行して、ImageBasedUpgrade CR の stage フィールドの値を Idle にパッチして、変更を終了します。

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge

   重要

   アップグレード後に Idle ステージに移行すると、変更をロールバックすることはできません。

   Lifecycle Agent は、アップグレードプロセス中に作成されたすべてのリソースを削除します。

5. アップグレードが成功したら、OADP Operator とその設定ファイルを削除できます。詳細は、「クラスターからの Operator の削除」を参照してください。

検証

1. 次のコマンドを実行して、ImageBasedUpgrade CR のステータスを確認します。

   $ oc get ibu -o yaml

   出力例

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "False"
       type: UpgradeInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "True"
       type: UpgradeCompleted
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-01-01T09:00:00Z"
     validNextStages:
     - Idle
     - Rollback

2. 次のコマンドを実行して、クラスターの復元ステータスを確認します。

   $ oc get restores -n openshift-adp -o custom-columns=NAME:.metadata.name,Status:.status.phase,Reason:.status.failureReason

   出力例

   NAME             Status      Reason
   acm-klusterlet   Completed   <none> 1
   apache-app       Completed   <none>
   localvolume      Completed   <none>

   1

   acm-klusterlet は RHACM 環境にのみ固有です。

手順

1. Rollback ステージに移行するには、次のコマンドを実行して、ImageBasedUpgrade CR の stage フィールドの値を Rollback にパッチします。

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Rollback"}}' --type=merge

   Lifecycle Agent は、以前にインストールされたバージョンの OpenShift Container Platform を使用してクラスターを再起動し、アプリケーションを復元します。

2. 正常に変更されたら、次のコマンドを実行して、ImageBasedUpgrade CR の stage フィールドの値を Idle にパッチして、ロールバックを終了します。

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge -n openshift-lifecycle-agent

   警告

   ロールバック後に Idle ステージに移行すると、Lifecycle Agent は失敗したアップグレードのトラブルシューティングに使用できるリソースをクリーンアップします。