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

手順

1. ハブクラスターで、ImageBasedGroupUpgrade CR を含む YAML ファイルを作成します。

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 1
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke1
         - spoke4
         - spoke6
     ibuSpec:
       seedImageRef: 2
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests: 3
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent: 4
       - name: oadp-cm
         namespace: openshift-adp
     plan: 5
     - actions: ["Prep"]
       rolloutStrategy:
         maxConcurrency: 2
         timeout: 2400

   1

   アップグレードするクラスター。

   2

   ターゲットプラットフォームのバージョン、使用するシードイメージ、およびイメージにアクセスするために必要なシークレット。

   3

   オプション: シードイメージに含まれていない追加のマニフェストをターゲットクラスターに適用します。カスタムカタログソースの ConfigMap オブジェクトも適用します。

   4

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

   5

   アップグレードプランの詳細。

2. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   $ oc apply -f <filename>.yaml

3. ハブクラスターで次のコマンドを実行して、ステータスの更新を監視します。

   $ oc get ibgu -o yaml

   出力例

   # ...
   status:
     clusters:
     - completedActions:
       - action: Prep
       name: spoke1
     - completedActions:
       - action: Prep
       name: spoke4
     - failedActions:
       - action: Prep
       name: spoke6
   # ...

   上記のサンプルプランの出力は、始めは Prep ステージだけです。前のステップの結果に基づいて、このプランにアクションを追加してください。TALM により、アップグレードが成功したか失敗したかを示すラベルがクラスターに追加されます。たとえば、Prep ステージに失敗したクラスターには、lcm.openshift.io/ibgu-prep-failed が適用されます。

   失敗を調査した後、アップグレードプランに AbortOnFailure ステップを追加できます。このステップにより、lcm.openshift.io/ibgu-<action>-failed というラベルの付いたクラスターが Idle ステージに戻されます。選択されたクラスターのアップグレードに関連するリソースがすべて削除されます。

4. オプション: 次のコマンドを実行して、既存の ImageBasedGroupUpgrade CR に AbortOnFailure アクションを追加します。

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   1. 次のコマンドを実行して、ステータスの更新の監視を継続します。

      $ oc get ibgu -o yaml

5. 次のコマンドを実行して、既存の ImageBasedGroupUpgrade CR にアクションを追加します。

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["Upgrade"], "rolloutStrategy": {"maxConcurrency": 2, "timeout": 30}}}]'

6. オプション: 次のコマンドを実行して、既存の ImageBasedGroupUpgrade CR に AbortOnFailure アクションを追加します。

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   1. 次のコマンドを実行して、ステータスの更新の監視を継続します。

      $ oc get ibgu -o yaml

7. 次のコマンドを実行して、既存の ImageBasedGroupUpgrade CR にアクションを追加します。

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["FinalizeUpgrade"], "rolloutStrategy": {"maxConcurrency": 10, "timeout": 3}}}]'

手順

1. ハブクラスターで、ImageBasedGroupUpgrade CR を含む YAML ファイルを作成します。

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 1
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke1
         - spoke4
         - spoke6
     ibuSpec:
       seedImageRef: 2
         image: quay.io/seed/image:4.17.0-rc.1
         version: 4.17.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests: 3
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent: 4
         - name: oadp-cm
           namespace: openshift-adp
     plan: 5
     - actions: ["Prep", "Upgrade", "FinalizeUpgrade"]
       rolloutStrategy:
         maxConcurrency: 200 6
         timeout: 2400 7

   1

   アップグレードするクラスター。

   2

   ターゲットプラットフォームのバージョン、使用するシードイメージ、およびイメージにアクセスするために必要なシークレット。

   3

   オプション: シードイメージに含まれていない追加のマニフェストをターゲットクラスターに適用します。カスタムカタログソースの ConfigMap オブジェクトも適用します。

   4

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

   5

   アップグレードプランの詳細。

   6

   バッチで更新するクラスターの数。

   7

   アクションを完了するまでのタイムアウト制限 (分単位)。

2. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   $ oc apply -f <filename>.yaml

手順

1. ハブクラスターで、ImageBasedGroupUpgrade CR を含む別の YAML ファイルを作成します。

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests:
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent:
       - name: oadp-cm
         namespace: openshift-adp
     plan:
     - actions: ["Abort"]
       rolloutStrategy:
         maxConcurrency: 5
         timeout: 10

   Prep ステージを完了したすべてのマネージドクラスターが、Idle ステージに戻ります。

2. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   $ oc apply -f <filename>.yaml

手順

1. ハブクラスターで、ImageBasedGroupUpgrade CR を含む別の YAML ファイルを作成します。

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
     - matchExpressions:
       - key: name
         operator: In
         values:
         - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.17.0-rc.1
         version: 4.17.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
     extraManifests:
       - name: example-extra-manifests
         namespace: openshift-lifecycle-agent
     oadpContent:
       - name: oadp-cm
         namespace: openshift-adp
     plan:
     - actions: ["Rollback", "FinalizeRollback"]
       rolloutStrategy:
         maxConcurrency: 200
         timeout: 2400

2. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   $ oc apply -f <filename>.yaml

   定義したラベルに一致するすべてのマネージドクラスターが、Rollback ステージに戻されます。その後 Idle ステージに移行してロールバックが完了します。