文档中心

容器服务

升级指南

升级 VCI Agent Sandbox

升级 VCI Agent Sandbox

本文主要介绍 Agent Sandbox 的版本升级操作。升级前请务必阅读目标版本的变更内容与变更影响说明，确保理解本次版本变更内容后再执行操作。

升级前准备

已了解和确认各版本 Kubernetes 兼容情况、版本变更内容以及变更影响，详情请参见版本变更记录。

对于 Agent Sandbox 应用所在集群，具有集群管理员权限，详情请参见配置 RBAC 权限。

由于部分版本存在变更影响，因此请提前评估影响范围，并在业务低峰期执行升级操作。

如当前版本为 v0.1.1 且使用了预热池功能，请先将预热池副本数缩容至 0，再执行升级操作。

如需保留通过 Service 访问 Sandbox 的能力，请提前规划好controller.defaultSandboxService参数的取值。

升级操作

登录容器服务控制台。

在左侧导航栏，选择应用中心 > Helm 应用。

在 Helm 应用页面选择目标集群和命名空间后找到待升级的 Agent Sandbox 应用。

在待升级 Agent Sandbox 应用右侧操作列下选择...> 更新。

在更新 Helm 应用页面编排模板区域的应用模板下拉菜单中，展开 agent-sandbox，选择目标版本。

选择目标版本后，单击values.yaml后的编辑按钮，填写部署参数。详细的参数说明，请参见安装指南。

核对参数无误后，点击页面下方的确定提交更新。

VKE 会自动完成 Helm Release 的滚动升级，可在 Helm 应用详情页观察发布状态与工作负载变化。

升级后验证

升级完成后，建议按以下顺序进行验证，确保应用运行正常：

在 Helm 应用页面确认 agent-sandbox 应用状态为已部署，且 Chart 版本为目标版本。

单击 Helm 应用名称，进入 Helm 应用详情页后确认 agent-sandbox-controller 工作负载类型和状态。类型已切换为 Deployment，且 Pod 均处于 Running 状态。

说明

v0.4.6 及以上版本 agent-sandbox-controller 工作负载类型为 Deployment，在此版本之前的 agent-sandbox-controller 工作负载类型为 StatefulSet。

agent-sandbox-controller 的状态必须全部就绪，即显示就绪：n/n。

创建一个测试 Sandbox，验证其能够正常达到 Running 状态并可被访问。详细操作，请参见生命周期管理。

（可选）如升级后出现异常，可在 Helm 应用页面通过历史版本功能回滚至上一稳定版本。回滚同样会经历短暂的组件不可用窗口，请谨慎操作。

最近更新时间：2026.07.15 10:52:48

这个页面对您有帮助吗？

有用

有用

无用

无用