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

   ここでは、以下のようになります。

   < ターゲットバージョン >

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

   < シードコンテナーイメージ >

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

   <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 は 準備 段階で指定された ConfigMap オブジェクトを検証します。

   以下のような問題が発生する可能性があります。

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

   検証警告は Upgrade ステージをブロックしませんが、アップグレードを続行しても安全かどうかを判断する必要があります。これらの警告 (たとえば、カスタムリソース定義 (CRD) や名前空間の欠落、ドライランの失敗など) は、Prep ステージの status.conditions と ImageBasedUpgrade CR の annotation フィールドを警告の詳細で更新します。以下の例は、これらの詳細を示しています。

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

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

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