Agent Runtime 镜像预热

一、概述

·镜像预热：提前准备沙箱运行所需的镜像，适用于镜像种类多、更新频繁的场景；

·模板快照：通过提前制作并复用模板快照加速启动沙箱，适用于镜像种类较少、重复使用频繁的场景。

这篇说说 AGS 的镜像预热能力。AGS 支持以下三类镜像预热方式：

·主动预热：在创建沙箱工具或启动沙箱实例之前，通过 AGS 控制台或 API 主动创建镜像预热；

·TCR 推送触发镜像预热：在 TCR 中配置镜像预热的触发规则，推送符合规则的镜像后自动触发预热；

·平台按需预热：在创建沙箱工具或启动沙箱实例时，由 AGS 根据镜像准备情况按需自动进行预热。

对于首批沙箱实例启动时延敏感的业务，建议在启动前主动预热镜像，或通过 TCR 推送触发镜像的自动预热，并在 AGS 控制台确认镜像预热成功后再启动沙箱实例。

二、预热流程

主动预热镜像从 TCR 自动预热 Agent 沙箱的镜像平台按需自动预热镜像你可以在创建沙箱工具或启动沙箱实例之前，通过 AGS 控制台或 API 主动预热镜像。1. 选择需要预热的镜像：确认预热的镜像及目标地域。2. 提交镜像预热请求：可以在 AGS 控制台中创建镜像预热，也可以调用 API 接口 提交镜像预热请求。3. 查看镜像预热结果：可以在 AGS 控制台中查询镜像预热的状态，也可以调用 API 接口 对镜像预热的状态进行查询。如果镜像正在预热，请等待预热完成；如果预热失败，请根据任务信息排查原因。你可以在 TCR 中配置镜像预热的触发规则，使 AGS 在镜像推送成功且符合触发规则时自动预热镜像，无需手动创建镜像预热。1. 配置镜像预热的触发规则：通过在 TCR 的触发器中配置镜像预热的触发规则确认需要自动预热的镜像所属的 TCR 实例、命名空间、仓库名称、版本 Tag 以及目标地域；2. 向 TCR 推送镜像：向指定的 TCR 实例推送符合触发规则的镜像，将触发 AGS 对该镜像进行自动预热；3. 查询镜像预热结果：可以在 AGS 控制台中查询镜像预热的状态，也可以调用 API 接口 对镜像预热的状态进行查询。确认预热成功后，即可使用已预热的镜像缓存创建沙箱工具或启动沙箱实例。创建沙箱工具或启动沙箱实例时，AGS 可以根据实际使用镜像的预热情况，按需自动预热镜像，无需你提前手动创建镜像预热。1. 确认需要使用的镜像：在创建沙箱工具或启动沙箱实例时，配置需要使用的镜像；2. 按需自动预热镜像：AGS 将检查目标镜像是否已经完成预热。如果尚未完成预热，平台则按需进行预热，并在镜像被成功预热后继续创建沙箱工具或启动沙箱实例。

注意：如果你需要使用“从 TCR 自动预热 Agent 沙箱中的镜像”的能力，请 提交工单 联系我们针对 TCR 实例当前的 Harbor 版本（v1.9 或 v2.0）分别进行升级。

三、镜像预热的状态机

镜像预热涉及以下状态：

说明：

·状态为 Pending / 排队中的镜像预热可以被取消。

·状态为 Success / 已预热时，已预热的镜像缓存可被用于加速启动沙箱。

·主动卸载时，若该镜像仍被未删除的沙箱工具、运行中的沙箱实例、暂停中的沙箱实例、模板快照等引用时，则不能被卸载。

·镜像预热的卸载将会卸载已预热的镜像缓存，但是不会删除镜像仓库中的源镜像。再次使用该镜像启动沙箱时，系统将重新对该镜像进行预热。

四、AGS 控制台

1. 登录 AGS 控制台。

2. 在镜像预热 管理页面，查看镜像预热列表中具体的镜像预热信息。

3. 单击镜像预热 ID，可以查看镜像预热的详情信息。

4. 单击新建镜像预热，通过选择或输入镜像地址来预热新的镜像。

5. 单击卸载，可以主动卸载指定的、已预热的镜像缓存。

五、使用限制

六、常见问题

1. 镜像已经预热成功，为什么沙箱启动仍慢或失败？

镜像预热只完成镜像的拉取、格式转换和存储，但是沙箱启动受到网络、存储挂载等依赖的影响，不能仅依据镜像预热的状态来判断沙箱是否启动成功。

2. 遇到预热准备中或失败时，如何处理？

查看创建镜像预热时可能出现的 错误码 及其对应的描述，来排查可能出现的问题。

3. 启动沙箱实例时，镜像仍在预热中，如何处理？

TCR 企业版镜像、CCR 个人版镜像：平台会在当前请求中等待镜像准备完成。如果等待结束时，查询到的镜像状态仍为 Processing，接口返回 ResourceUnavailable，并提示镜像仍在准备中，请稍后重试。

七、与快照加速的区别

注意：说明：

注意：镜像预热解决“镜像还没有准备好”的问题，模板快照解决“沙箱启动配置初始化太慢”的问题，两者适用的场景不同，不是互相替代的关系。