#升级 global 集群

#上传镜像

将核心软件包复制到 global 集群的任意控制平面节点。解压软件包，并将 cd 放入解压后的目录。

• 如果 global 集群使用内置镜像仓库，请运行：

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

• 如果 global 集群使用外部镜像仓库，还需要提供镜像仓库地址：

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

如果计划在升级 global 集群期间同时升级 Operator 和集群插件，可以提前将它们的镜像推送到 global 集群的镜像仓库。 批量上传说明请参阅仅推送目录中所有软件包的镜像。

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

#触发升级

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

bash upgrade.sh --skip-sync-image

请等待脚本运行完成后再继续。

如果已将 Operator 和集群插件镜像预先推送到 global 集群的镜像仓库，则可以按照仅从目录中的所有软件包创建 CR操作。运行此命令后，请等待约 10–15 分钟，直到出现功能组件的升级通知。随后，您便可以在后续升级步骤中同时升级 Operator 和集群插件。

#升级 global 集群

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

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

#安装 Product Docs 插件

从 4.0 开始，内置产品文档已从平台中拆分出来，成为 Alauda Container Platform Product Docs 插件。如果您要从 3.x 升级，则需要按照以下步骤安装此插件：

1. 导航至管理员。

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

3. 找到 Alauda Container Platform Product Docs 插件，然后点击安装。

#（条件）安装 Service Mesh Essentials

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

#验证数据一致性

按照常规 global DR 检查流程，确保备用 global 集群中的数据与主 global 集群一致。

如果检测到数据不一致，请勿在下一步卸载 etcd sync 插件，并在继续操作前联系技术支持。如果备用 global 集群缺少主集群中已有的数据，在这种情况下卸载插件可能会导致 owner 引用解析错误，并可能删除业务集群节点 Machine 对象——包括不可变操作系统集群，在这种情况下，删除对象会导致其底层虚拟机被销毁。

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

kubectl get machines.platform.tkestack.io

如果存在此类节点，请联系技术支持，在继续操作前解决问题。

#卸载 etcd sync 插件

helm3 del etcd-sync -n default 2> /dev/null
helm3 del etcd-sync -n cpaas-system 2> /dev/null

kubectl delete configmaps,secret -n kube-system   etcd-master-mirror-cert etcd-slave-mirror-cert etcd-sync-env   etcd-sync-ignore-text &> /dev/null

kubectl delete deploy -n kube-system etcd-mirror-etcd-mirror &> /dev/  null

kubectl get pod -n kube-system | grep etcd-mirror  # Ensure no   etcd-mirror pods remain

#上传镜像

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

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

#升级备用集群

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

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

#升级主集群

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

#重新安装 etcd sync 插件

重新安装前，请确认两个 global 集群 VIP 的端口 2379 均已正确转发至其控制平面节点。

重新安装步骤：

1. 通过 IP 或 VIP 访问备用 global 集群的 Web Console。
2. 切换到管理员视图。
3. 前往 Marketplace > 集群插件。
4. 选择 global 集群。
5. 找到 Alauda Container Platform Global Cluster Disaster Recovery（对于重命名前发布的软件包，该插件显示为 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:" – 备用集群中存在这些键，但主集群中没有。删除前，请与运维团队一起审查这些键。