#升级业务集群

#确认业务集群前提条件

在发起升级之前，请确认：

• 业务集群版本低于当前 global 集群版本。
• global 层已达到目标 ACP Distribution Version。
• 在 global DR 环境中，备用和主用 global 集群都已达到该目标 Distribution Version。

#operator 推送回退

升级 global 集群 中推荐的模式会在 global 升级窗口期间将 operator package 推送到每个 集群。如果已按建议执行，则业务集群已经具备所需的全部 operator package，可以跳过本节。

cluster plugin 不需要按业务集群逐个推送。只要某个 cluster plugin 已在 global 层推送一次，就可以在平台中的每个集群上安装和升级。

如果 global 窗口没有将 operator package 推送到此业务集群——例如，该集群在 global 窗口期间处于离线状态，或者是在之后才添加的——则在发起升级请求之前，请将每个正在使用的 operator package 推送到该业务集群：

violet push <path/to/operator-package> \
  --platform-address "https://<your-platform-domain>" \
  --platform-token "<platform_token>" \
  --clusters "<workload-cluster-name>"

你只需要为业务集群上实际运行的 operator 推送 operator package。仍留在 global 侧的 Aligned plugin package 会在业务集群升级期间由 CVO 自动获取。

#运行 preflight 检查

时间： 在维护窗口前 1–2 周执行，以便在窗口开启前有时间解决任何阻塞项。

以 preflight 模式针对目标集群运行 upgrade.sh：

bash upgrade.sh --cluster=<cluster> --preflight

Preflight 是只读操作——它会验证升级就绪状态，不会更改集群状态。

Preflight 会返回两部分内容：

如果 preflight 未通过，请不要提交升级请求，直到所有阻塞项都已解决。

关于 preflight 阻塞处理模式，请参见 按需处理 preflight 阻塞。

#发起升级

时间： 在维护窗口期间，并且在 preflight 通过之后。

通过以下任一入口发起升级。这两个入口等效；请选择符合你运维模式的方式。

# Request upgrade to the highest version currently published in availableUpdates
ac adm upgrade --cluster=<cluster> --to-latest

# Request upgrade to a specific target version
ac adm upgrade --cluster=<cluster> --to=4.3.0

#观察进度

在升级请求提交后，使用 cvsh.status 跟踪当前版本、目标版本、preflight 结果、阶段和历史记录：

kubectl get cvsh <cluster> -n cpaas-system
kubectl get cvsh <cluster> -n cpaas-system -o yaml

如果当前 ACP 上下文指向目标业务集群，也可以查看 CLI 返回的状态：

# Show summary, preflight, and stage progress for the target cluster upgrade
ac adm upgrade status

关于 ac adm upgrade status 输出的详细语义（preflight 和阶段解读），请参见 升级集群。

上述命令跟踪的是集群级别（Core 和 Aligned）的升级。若要观察单个 plugin 或 operator module——例如在升级 Agnostic plugin 时——请读取其 ModuleInfo：

kubectl get moduleinfo -l cpaas.io/cluster-name=<cluster> \
  -o custom-columns='MODULE:.metadata.labels.cpaas\.io/module-name,CURRENT:.status.version,TARGET:.spec.version,NEW:.status.availableVersions[0].version,PHASE:.status.phase'

当 status.phase 为 Running 且 status.version 等于目标版本时，表示该 module 已达到目标版本。

#从 Marketplace 升级 Agnostic plugins

CVO 负责驱动 Core 和 Aligned plugin。Agnostic plugin 不在 CVO 的范围内，必须在该业务集群达到目标 Distribution Version 后单独升级。

对此业务集群上每个正在使用的 Agnostic plugin：

1. 在 Web Console 中切换到 Administrator 视图。
2. 导航到 Marketplace > Cluster Plugins，以管理 Agnostic cluster plugin；或者导航到 Agnostic operator 的 operator 工作流。
3. 选择目标 plugin 或 operator 并触发升级。

每个 Agnostic plugin 是否需要在本窗口中升级，取决于其自身的 Kubernetes 兼容性——请查看该 plugin 的 release notes，以确认其与业务集群已达到的新 Kubernetes 版本是否兼容。

如果 Marketplace 未提供此业务集群上某个 operator 的目标版本，请先完成该 operator 的 operator 推送回退，然后重新尝试 Marketplace 升级。

排障时，请首先检查 conditions、preflight 详情和历史记录：

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{.status.preflight.observedAt}{"\n"}{range .status.preflight.checks[*]}{.name}{"\t"}{.policy}{"\t"}{.state}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{range .status.history[*]}{.version}{"\t"}{.state}{"\t"}{.startedTime}{"\t"}{.completionTime}{"\n"}{end}'