#生命周期策略

Alauda Build 的 Agent Sandbox 是一个可独立安装的集群插件。其发布周期和版本号均独立于 ACP 核心发布周期。

#独立发布周期

ACP 发布流可以支持某个 Agent Sandbox 版本，而无需使用相同的版本号。在规划安装或升级时，请务必同时确认这两个版本：

• ACP 发布流用于标识平台兼容性目标。
• 产品和 ModulePlugin 版本用于标识可安装的 Agent Sandbox 包。
• Helm Chart 版本用于标识打包后的 chart 元数据。
• Upstream 版本用于标识 Kubernetes SIGs 的源基线。

#支持的版本组合

以下组合已针对本 Tech Preview 进行验证：

该包可在 Application Center 中用于 ACP v4.4 发布流。此页面不会将兼容性扩展到其他尚未验证的 ACP 发布流。

#升级策略

由于 upstream v0.5.4 更改了可观察的 API 和状态行为，因此升级风险等级为 High。升级前：

1. 查看 发行说明 中的破坏性变更和行为变更。
2. 清点读取 Sandbox conditions 或编辑 volume claim templates 的自动化流程。
3. 保存重要的自定义资源清单。
4. 确认持久化数据具有适合该应用的备份或恢复路径。
5. 升级后验证 controller 和现有 Sandboxes。

使用 Upgrade 更改插件版本。仅使用 Update 更改当前已安装版本的配置。

#回滚边界

此版本不保证无损降级。回滚 controller 无法自动恢复旧客户端对 condition 是否存在以及 reason 字符串的假设。它也无法使对 spec.volumeClaimTemplates 的无效原地更新变为有效。

如果工作负载定义必须更改不可变的 volume claim template，请创建一个替代 Sandbox，并通过应用控制的流程迁移数据。

#Tech Preview 支持范围

本文档记录了针对 ACP v4.4 已验证的版本组合和行为。它未定义未经批准的生命周期结束日期、维护窗口或生产服务级别协议。在评估生产环境使用时，请遵循 ACP Tech Preview 政策以及贵组织的变更管理要求。