15.3. 使用 Lifecycle Agent 为单节点 OpenShift 集群执行基于镜像的升级

流程

1. 检查您是否修补了 ImageBasedUpgrade CR:

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

   1

   指定目标平台版本。该值必须与 seed 镜像的版本匹配。

   2

   指定目标集群可从中拉取 seed 镜像的存储库。

   3

   如果镜像位于私有 registry 中，则指定对带有凭证的 secret 的引用。

   4

   （可选）指定在第一次重启后在那个时间段内回滚的时间帧（以秒为单位）。如果没有定义或设置为 0，则使用默认值 1800 秒 (30 分钟)。

   5

   （可选）指定要在升级后保留的自定义目录源的 ConfigMap 资源列表，以及要应用到不是 seed 镜像一部分的目标集群的额外清单。

   6

   使用 OADP ConfigMap 信息添加 oadpContent 部分。

2. 要启动 Prep 阶段，请运行以下命令将 stage 字段的值改为 ImageBasedUpgrade CR 中的 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、命名空间或空运行失败）更新 ImageBasedUpgrade CR 中的 Prep 阶段和 annotation 字段的 status.conditions，其中包含有关警告的详情。

   验证警告示例

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

   但是，验证错误，如将 MachineConfig 或 Operator 清单添加到额外清单中，从而导致 Prep 阶段失败并阻止 Upgrade 阶段。

   当验证通过时，集群会创建一个新的 ostree stateroot，它涉及拉取和解包 seed 镜像，并运行主机级命令。最后，目标集群中会包括所有必需的镜像。

流程

1. 要移到 Upgrade 阶段，请运行以下命令将 ImageBasedUpgrade CR 中的 Upgrade 的 stage 字段的值改为 Upgrade：

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Upgrade"}}' --type=merge

2. 运行以下命令，检查 ImageBasedUpgrade CR 的状态：

   $ oc get ibu -o yaml

   输出示例

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: |-
         Waiting for system to stabilize: one or more health checks failed
           - one or more ClusterOperators not yet ready: authentication
           - one or more MachineConfigPools not yet ready: master
           - one or more ClusterServiceVersions not yet ready: sriov-fec.v2.8.0
       observedGeneration: 1
       reason: InProgress
       status: "True"
       type: UpgradeInProgress
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-05-19T14:01:52Z"
     validNextStages:
     - Rollback

   OADP Operator 创建 OADP Backup 和 Restore CR 中指定的数据的备份，目标集群重启。

3. 运行以下命令监控 CR 的状态：

   $ oc get ibu -o yaml

4. 如果您对升级满意，请运行以下命令在 ImageBasedUpgrade CR 中将 stage 字段的值修补为 Idle 来完成更改：

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge

   重要

   在升级后，一旦进入 Idle 阶段将无法回滚进行的改变。

   Lifecycle Agent 会删除升级过程中创建的所有资源。

5. 您可以在成功升级后删除 OADP Operator 及其配置文件。如需更多信息，请参阅"从集群中删除 Operator"。

验证

1. 运行以下命令，检查 ImageBasedUpgrade CR 的状态：

   $ oc get ibu -o yaml

   输出示例

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "False"
       type: UpgradeInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "True"
       type: UpgradeCompleted
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-01-01T09:00:00Z"
     validNextStages:
     - Idle
     - Rollback

2. 运行以下命令检查集群恢复的状态：

   $ oc get restores -n openshift-adp -o custom-columns=NAME:.metadata.name,Status:.status.phase,Reason:.status.failureReason

   输出示例

   NAME             Status      Reason
   acm-klusterlet   Completed   <none> 1
   apache-app       Completed   <none>
   localvolume      Completed   <none>

   1

   acm-klusterlet 只特定于 RHACM 环境。

流程

1. 要进入回滚阶段，运行以下命令将 ImageBasedUpgrade CR 中的 stage 字段的值设置为 Rollback：

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Rollback"}}' --type=merge

   Lifecycle Agent 使用之前安装的 OpenShift Container Platform 版本重启集群，并恢复应用程序。

2. 如果您对更改满意，请运行以下命令在 ImageBasedUpgrade CR 中将 stage 字段的值修补为 Idle 来完成回滚：

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge -n openshift-lifecycle-agent

   警告

   如果在回滚后移至 Idle 阶段，则 Lifecycle Agent 会清理可用于对失败的升级进行故障排除的资源。