#升级 global 集群

#上传镜像

将 core package 复制到 global 集群的 任意控制平面节点。解压该 package，然后 cd 到解压后的目录。

• 如果 global 集群使用 内置 registry，请运行：

  bash upgrade.sh --only-sync-image=true

• 如果 global 集群使用 外部 registry，还需要提供 registry 地址：

  bash upgrade.sh --only-sync-image=true --registry <registry-address> --username <username> --password <password>

如果您计划在升级 global 集群的同时升级 Operator 和 Cluster Plugin，请提前将相应的软件包推送到对应集群的 registry。 有关批量上传说明，请参见 一次性推送所有软件包。

有关 violet push 子命令的详细信息，请参见 上架软件包。

#触发升级

镜像上传完成后，运行以下命令以启动升级流程：

bash upgrade.sh --skip-sync-image

请等待脚本执行完成后再继续。大约需要 10–15 分钟，功能组件 选项卡中的升级按钮才会可用。之后，您就可以按照下面的升级说明升级 Operator 和 Cluster Plugin。

#升级 global 集群

1. 登录 global 集群的 Web Console，并切换到 管理员 视图。
2. 导航到 集群 > 集群。
3. 单击 global 集群，打开其详情视图。
4. 转到 功能组件 选项卡。
5. 单击 升级 按钮。

在对话框中查看可用的组件更新，并确认继续。

#安装 Alauda Container Platform Cluster Enhancer 插件

1. 导航到 管理员。

2. 在左侧边栏中，单击 Marketplace > 集群插件，并选择 global 集群。

3. 找到 Alauda Container Platform Cluster Enhancer 插件，然后单击 安装。

#（条件性）升级 Service Mesh Essentials

如果已安装 Service Mesh v1，请在升级 workload 集群之前参考 Alauda Service Mesh Essentials 集群插件 文档。

#验证数据一致性

请按照常规的 global DR 检查操作步骤，确保 备用 global 集群中的数据与主 global 集群一致。

如果检测到不一致，请不要执行下一步中的 etcd 同步插件卸载，并在继续之前联系技术支持。当备用 global 集群缺少主集群持有的数据时卸载该插件，可能会导致 owner reference 解析错误，并且 workload 集群中的 Machine 节点对象——包括 immutable-OS 集群，在这种情况下会破坏其底层虚拟机——可能会被删除。

在两个集群上运行以下命令，以确保没有 Machine 节点处于非运行状态：

kubectl get machines.platform.tkestack.io

如果存在此类节点，请联系技术支持解决后再继续。

#卸载 etcd 同步插件

1. 通过 IP 或 VIP 访问 备用集群的 Web Console。
2. 切换到 管理员 视图。
3. 导航到 Marketplace > 集群插件。
4. 务必确认您已切换到 global 集群。
5. 找到 Alauda Container Platform etcd Synchronizer 插件并将其卸载。等待卸载完成。

#上传镜像

在备用集群和主集群上都执行 上传镜像 步骤。

详情请参见 标准操作步骤中的上传镜像。

#升级备用集群

apiVersion: product.alauda.io/v1alpha2
kind: ProductBase
metadata:
  name: base
spec:
  alternativeURLs:
    - https://<standby-cluster-vip>

在备用集群上，按照 标准操作步骤 完成升级。

#升级主集群

备用集群升级完成后，在主集群上继续执行 标准操作步骤。

#重新安装 etcd 同步插件

在重新安装之前，请确认端口 2379 已从两个 global 集群 VIP 正确转发到各自的控制平面节点。

重新安装：

1. 通过 IP 或 VIP 访问 备用 global 集群的 Web Console。
2. 切换到 管理员 视图。
3. 转到 Marketplace > 集群插件。
4. 选择 global 集群。
5. 找到 Alauda Container Platform etcd Synchronizer，单击 安装，并提供所需参数。

验证安装：

kubectl get po -n cpaas-system -l app=etcd-sync  # Ensure pod is 1/1 Running

kubectl logs -n cpaas-system $(kubectl get po -n cpaas-system -l app=etcd-sync --no-headers | awk '{print $1}' | head -1) | grep -i "Start Sync update"
# Wait until the logs contain "Start Sync update"

# Recreate the pod to trigger synchronization of resources with ownerReferences
kubectl delete po -n cpaas-system $(kubectl get po -n cpaas-system -l app=etcd-sync --no-headers | awk '{print $1}' | head -1)

#检查同步状态

运行以下命令以验证同步状态：

curl "$(kubectl get svc -n cpaas-system etcd-sync-monitor -ojsonpath='{.spec.clusterIP}')/check"

输出说明：

• "LOCAL ETCD missed keys:" – 这些键存在于主集群中，但在备用集群中缺失。通常在重启 Pod 后即可解决。
• "LOCAL ETCD surplus keys:" – 这些键存在于备用集群中，但在主集群中不存在。请在删除之前与运维团队一起检查这些键。