升级#

#安装最新的全局 Alauda Service Mesh Essentials 集群插件

请访问 Alauda Service Mesh Essentials 了解安装说明。

#将最新的 Operators 上传到全局和目标集群

将以下 operator 的最新版本上传到 全局 集群和目标集群（请不要手动安装）：

• Alauda Service Mesh Operator
• Flagger Operator
• Alauda Build of Jaeger Operator
• Alauda Build of OpenTelemetry Operator

使用 violet 工具的上传操作步骤，请访问 安装 Operator。

#升级业务集群组件

#升级前

平台为 service mesh 中的 Istio 提供金丝雀升级，新版本的 istiod 组件会优先部署。待所有 data plane 都升级完成后，旧版本的 istiod 组件将被下线。

由于 Istio 版本与 Kubernetes 版本之间存在很强的依赖关系，因此在升级 Istio 之前，请确保集群当前的 Kubernetes 版本满足 Istio 升级要求，以便成功完成金丝雀升级。

下表展示了当前平台版本支持的 Istio 升级路径，以及这些路径所要求的 Kubernetes 版本。

说明：

• 表中仅描述 Istio 和 Kubernetes 的主版本；次版本不会影响兼容性。
• 你可以通过进入 Components 列表查看集群中当前运行的 Istio 和 Kubernetes 版本。
• 如果集群当前的 Kubernetes 版本低于 Istio 升级所需版本，则需要通过 升级组件 将 Kubernetes 升级到兼容版本。
• 更多信息请参见 Community 的 Istio 支持的 Kubernetes 版本。

#升级操作步骤

完整的 service mesh 升级流程包括以下步骤：

1. 升级集群中的 service mesh 非 Istio 组件，例如 asm operator、flagger operator 等。
2. 在集群中部署新版本的 istiod。
3. 检查集群中是否存在 EnvoyFilters。
4. 升级集群中的所有 Istio data plane。
5. 下线集群中的旧版本 istiod。

#升级操作

#升级集群中的 service mesh 非 Istio 组件

1. 在左侧导航栏的 Platform Management 中，点击 Service Mesh > Meshes。
2. 点击需要升级的 Service Mesh Name，进入网格详情页。
3. 在网格详情页的 Mesh Deployment 区域中，会列出已部署 service mesh 的集群。点击 Cluster Name，在新标签页中打开集群详情页。
4. 在集群详情页切换到 Components，然后点击升级，将集群中的 service mesh 非 Istio 组件升级到最新版本。有关升级组件的详细说明，请参见 升级组件。

说明：service mesh 的非 Istio 组件包括 asm、Flagger Operator、Asm Operator、Jaeger Operator。

#部署新版本的 istiod

说明：在部署新版本的 istiod 之前，请先参考 升级前，确保集群的 Kubernetes 版本满足升级路径要求。

1. 返回网格详情页，在 Mesh Deployment 区域中，点击对应集群的 Istio Version 右侧的 Upgrade 按钮。弹窗中会显示 Istio 的升级路径。
2. 在弹窗中点击 Upgrade 按钮。

#检查集群中是否存在 EnvoyFilters

1. 在左侧导航栏的 Platform Management 中，点击 Service Mesh > EnvoyFilter。

   说明：如果平台上有多个 service mesh，可以通过顶部导航栏切换到集群所在的 service mesh。

2. 检查 EnvoyFilter 列表中是否有数据。

   • 如果未找到数据，说明检查完成。
   • 如果找到了数据，请联系 EnvoyFilter 创建者，使所有 EnvoyFilters 适配新版本的 Istio，或者联系技术支持。

#升级集群中的所有 Istio data plane

集群中的 Istio data plane 包括 Sidecar、ingress gateway 和 egress gateway。

方式 1：通过交互式命令行工具升级

交互式命令行工具可以批量升级集群中的所有 Sidecar 和 gateway。此方式适合熟悉命令行操作的用户，尤其适合需要一次性快速升级整个集群的场景。

kubectl -ncpaas-system exec -it deploy/asm-controller -- /app/asm-controller bfg rollout

说明：你也可以使用快速升级参数，在不确认的情况下执行升级。

kubectl -ncpaas-system exec -it deploy/asm-controller -- /app/asm-controller bfg rollout --no-prompt

说明：ingress 和 egress gateway 的滚动升级过程会先删除旧 Pod，再创建新 Pod，直到所有 Pod 都更新为新的 data plane 镜像版本。因此，如果 gateway 只有一个 Pod，那么在 gateway 升级期间它将不可访问。

方式 2：通过 UI 升级

通过 UI 升级可以按不同的 namespace 批量升级，也可以指定单个 service/gateway 进行升级。此方式适合偏好在图形界面中操作的用户，尤其适合需要灵活选择升级目标的场景。

升级 ingress 和 egress gateway

1. 在左侧导航栏中，点击 Service Mesh > Gateways。 说明：在集群的 gateway 列表中，Istio Version 右侧的 图标表示该 gateway 的 data plane proxy 可以升级。
2. 点击 Istio Version 右侧的 Upgrade 按钮，然后点击 Confirm。

升级 Sidecar

1. 在左侧导航栏的 Platform Management 中，点击 Service Mesh > Meshes。
2. 点击需要升级 Sidecar 的 Service Mesh Name，进入网格详情页。
3. 在网格详情页的 Namespaces 区域中，会列出该 service mesh 管理的 namespace。点击 Namespace Name，在新标签页中打开 Service Mesh，并进入 Sidecar 所在的 namespace。 说明：请按顺序依次对所有 namespace 执行 Sidecar 升级。
4. 在左侧导航栏中，点击 Service List。 说明：当 Service Name 旁边出现 图标时，表示该 service 的 Sidecar 可以升级。
5. 点击 Batch Upgrade Sidecars。 说明：点击 service 记录中 图标右侧的 Upgrade 按钮，可以升级单个 service。
6. 选择全部、一个或多个 service，然后点击 Upgrade。 说明：平台会通过滚动更新具有不同当前版本和目标版本 Sidecar 的 Pod 来升级 service 的 Sidecar。如果升级失败，请检查 Container Platform 中的 container group 事件以了解失败原因，或者尝试 Re-upgrade。

说明：Sidecar 通过对 service 的 Deployment 进行滚动更新来完成 Pod 的 data plane 镜像更新。因此，如果 service 存在长连接，在 Pod 滚动更新期间会出现短暂的服务中断。

#下线集群中的旧版本 istiod

只有在集群中的所有 Istio data plane 都升级完成后，才能下线集群中的旧版本 istiod。

注意：

• 如果集群中的旧版本 istiod 未下线，将无法使用 service mesh 的 add cluster 和 Sidecar 配置功能。
• 当平台上存在新的可升级版本时，如果有任何集群尚未下线旧版本 istiod，平台将无法升级。
• 在多集群 service mesh 中，只有在所有集群都完成 Istio data plane 升级后，才能按顺序逐个下线各集群中的旧版本 istiod。

操作步骤

1. 返回网格详情页，在 Mesh Deployment 区域中，点击对应集群的 Istio Version 右侧的 Decommission Old Version 按钮。此时会显示 Decommission Old Version 弹窗。
2. 在弹窗中点击 Confirm 按钮。

说明：如果集群中仍有未升级的数据平面，点击 Decommission Old Version 后，弹窗会显示集群中尚未升级的 ingress gateway、egress gateway 和 Sidecar，便于快速跟踪待升级的数据平面。