#发版日志

发版日志描述了 Alauda Build of Agent Sandbox 的用户可见增强、兼容性变更和已知限制。

#支持的版本

#v0.5.4-1

#发版信息

#功能与增强

• 改进了 warm-pool 接管、重启行为、期望跟踪以及 controller 稳定性。
• 新增乐观锁和接管冲突处理，以支持更安全的并发调谐。
• 恢复了 SandboxTemplate 的 hash 标签向 Pods 的传播，以便基于模板生成的 NetworkPolicies 能够选择预期的工作负载。
• 在 Helm 渲染受支持的 controller 参数时，保留显式的 false 和 0 值。
• 新增当前 controller 行为所需的 Kubernetes Event 权限。
• 通过 Sandbox Service 暴露声明的容器端口。
• 包含来自 upstream v0.5.4 的 controller 生命周期、cache、connection-sharding、webhook 证书和效率改进。

ACP 动态表单仍然有意仅限于 controller replicas、extension controllers、resources、node selector 和 tolerations。本次发版不会将其他 upstream 标志作为重叠的 ACP 表单控件暴露出来。

#破坏性变更和行为变更

#Suspended 条件约定

Sandbox.status.conditions[type=Suspended] 在初始调谐后仍然存在。客户端必须检查该条件的布尔 status，而不是将条件是否存在解释为 suspended 状态。

终止原因从 PodNotTerminated 变更为 PodTerminating。请更新会比较旧原因字符串的脚本、仪表盘和告警规则。

#不可变的 volume claim templates

Sandbox.spec.volumeClaimTemplates 在创建后不可变。任何新增、删除或修改 volume claim template 的更新都会被拒绝。当模板必须变更时，请创建一个替代的 Sandbox。

#Python SDK 连接选项

upstream Python SDK 已移除 use_pod_ip 选项。仍然传递该选项的 SDK 使用方必须在采用相应 SDK 版本之前更新代码。

#已知限制

• extension controllers 默认处于禁用状态。使用 SandboxTemplate、SandboxWarmPool 或 SandboxClaim 之前，请先启用 controller.extensions。
• shutdownTime 是绝对过期时间，而不是空闲超时。活动不会自动延长它。
• PersistentVolumeClaims 会保留卷数据，但不会快照容器环境中已安装的软件包或操作系统变更。
• 该产品不为不应使用 Kubernetes 凭据的客户端提供外部 HTTP API gateway。
• Kata Containers 或 gVisor 等 RuntimeClass 实现必须由集群管理员单独安装和运维。

内部打包、扫描治理注册以及 uploader 重试细节属于 release engineering 证据，不是产品已知问题。