15.4. 使用 GitOps ZTP 为单节点 OpenShift 集群执行基于镜像的升级

流程

1. 在 hub 集群上创建一个包含 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

   目标平台版本、要使用的 seed 镜像以及访问镜像所需的 secret。

   3

   可选：将不在 seed 镜像中的额外清单应用到目标集群。另外，为自定义目录源应用 ConfigMap 对象。

   4

   包含 OADP Backup 和 Restore CR 的 ConfigMap 资源列表。

   5

   升级计划详情。

2. 在 hub 集群中运行以下命令来应用创建的文件：

   $ oc apply -f <filename>.yaml

3. 在 hub 集群中运行以下命令来监控状态更新：

   $ oc get ibgu -o yaml

   输出示例

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

   示例计划前面的输出仅以 Prep 阶段开始，您可以根据上一步的结果向计划添加操作。如果升级成功或失败，TALM 会在集群中添加标签来标记集群。例如，lcm.openshift.io/ibgu-prep-failed 应用到 Prep 阶段失败的集群。

   调查失败后，您可以在升级计划中添加 AbortOnFailure 步骤。它将带有 lcm.openshift.io/ibgu-<action>-failed 标记的集群移到 Idle 阶段。与所选集群中升级相关的资源都会被删除。

4. 可选：通过运行以下命令，将 AbortOnFailure 操作添加到现有的 ImageBasedGroupUpgrade CR 中：

   $ 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. 可选：通过运行以下命令，将 AbortOnFailure 操作添加到现有的 ImageBasedGroupUpgrade CR 中：

   $ 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. 在 hub 集群上创建一个包含 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

   目标平台版本、要使用的 seed 镜像以及访问镜像所需的 secret。

   3

   可选：将不在 seed 镜像中的额外清单应用到目标集群。另外，为自定义目录源应用 ConfigMap 对象。

   4

   包含 OADP Backup 和 Restore CR 的 ConfigMap 资源列表。

   5

   升级计划详情。

   6

   批处理中要更新的集群数量。

   7

   完成操作的超时限制（以分钟为单位）。

2. 在 hub 集群中运行以下命令来应用创建的文件：

   $ oc apply -f <filename>.yaml

流程

1. 在 hub 集群上创建一个包含 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. 在 hub 集群中运行以下命令来应用创建的文件：

   $ oc apply -f <filename>.yaml

流程

1. 在 hub 集群上创建一个包含 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. 在 hub 集群中运行以下命令来应用创建的文件：

   $ oc apply -f <filename>.yaml

   所有与定义的标签匹配的受管集群都会移到 Rollback 中，然后进入 Idle 阶段来完成回滚。