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

手順

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

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

   各項目の説明:

   <target_version>

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

   <seed_container_image>

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

   <seed_pull_secret>

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

   <initMonitorTimeoutSeconds>

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

   extraManifests

   オプション: ConfigMap リソースのリストです。これらのリソースには、アップグレード後も保持されるカスタムカタログソースと、シードイメージに含まれていない追加のマニフェストが含まれています。

   oadpContent

   OADP の Backup および Restore CR を含む ConfigMap リソースのリスト。

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 を作成します。これには、シードイメージのプルと展開、およびホストレベルのコマンドの実行が含まれます。最後に、Lifecycle Agent は、対象クラスター上で必要なすべてのイメージを事前にキャッシュします。