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

手順

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

   Copy to Clipboard Toggle word wrap

   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

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

   注記

   ハブクラスターの ImageBasedGroupUpgrade リソースと同じ namespace にシードイメージプルシークレットを追加すると、そのシークレットが Prep ステージのマニフェストリストに追加されます。シークレットは、openshift-lifecycle-agent namespace 内の各スポーククラスターで再作成されます。

   3

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

   4

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

   5

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

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

   Copy to Clipboard Toggle word wrap

   $ oc apply -f <filename>.yaml

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

   Copy to Clipboard Toggle word wrap

   $ oc get ibgu -o yaml

   出力例

   Copy to Clipboard Toggle word wrap

   # ...
   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 アクションを追加します。

   Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

      $ oc get ibgu -o yaml

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

      $ oc get ibgu -o yaml

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

   Copy to Clipboard Toggle word wrap

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

手順

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

   Copy to Clipboard Toggle word wrap

   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.18.0-rc.1
         version: 4.18.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

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

   注記

   ハブクラスターの ImageBasedGroupUpgrade リソースと同じ namespace にシードイメージプルシークレットを追加すると、そのシークレットが Prep ステージのマニフェストリストに追加されます。シークレットは、openshift-lifecycle-agent namespace 内の各スポーククラスターで再作成されます。

   3

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

   4

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

   5

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

   6

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

   7

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

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

   Copy to Clipboard Toggle word wrap

   $ oc apply -f <filename>.yaml

手順

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

   Copy to Clipboard Toggle word wrap

   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. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   Copy to Clipboard Toggle word wrap

   $ oc apply -f <filename>.yaml

手順

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

   Copy to Clipboard Toggle word wrap

   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.18.0-rc.1
         version: 4.18.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. ハブクラスターで次のコマンドを実行して、作成したファイルを適用します。

   Copy to Clipboard Toggle word wrap

   $ oc apply -f <filename>.yaml

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