概要
Agent 沙箱（AGS）支持通过 容器镜像服务（TCR）的镜像推送事件触发镜像的自动预热。您只需在 TCR 中配置镜像预热的触发规则，当向 TCR 实例推送符合触发规则的镜像时，AGS 将自动对该镜像进行预热，无需您在 AGS 中手动创建镜像预热。
您可以通过以下流程使用自动预热镜像的功能：
镜像被成功预热后，您可以使用该镜像创建沙箱工具或启动沙箱实例，减少首次使用镜像时的准备时间。
前提条件
使用 AGS 从 TCR 自动预热镜像的能力之前，请确认满足以下条件：
条件 | 说明 |
开通能力 | |
CAM 授权 | 预热动作依赖服务角色 TCR_QCSRole 绑定预设策略 QcloudAccessForAgsRoleInTCR。首次配置镜像预热触发规则时控制台会弹出授权窗口；子账号无 CAM 授权权限时，需由主账号完成授权。 |
地域要求 | 预热的目标地域是 AGS 所在地域。TCR 实例与 AGS 需保持同地域，不支持跨地域预热。 |
命名空间 | 在 TCR 实例中已创建至少一个命名空间，镜像预热的触发规则以命名空间为维度。 |
操作步骤
操作一：在 TCR 实例中配置镜像预热的触发规则
2. 在指定 TCR 实例中“新建”触发器，为镜像推送事件创建镜像预热的触发规则。
3. 按照提示配置需要自动预热的镜像范围，包括命名空间、仓库名称、版本 Tag 以及镜像预热的目标地域。
4. 确认配置无误后，保存触发规则。
步骤二：向指定的 TCR 实例推送镜像
向已配置镜像预热触发规则的 TCR 实例推送符合规则的镜像。镜像推送成功后，AGS 将自动触发镜像预热，无需您手动创建预热任务。
步骤三：在 AGS 侧查看镜像预热的状态和结果
2. 找到已推送镜像对应的预热信息，查看镜像预热的状态和结果。
镜像被成功预热后，您可以在创建沙箱工具或启动沙箱实例时使用相应版本的镜像，无需手动重复预热。
说明：
如需通过 API 查询镜像预热结果，也可以调用
DescribePreCacheImageTask 接口。常见问题与排查
现象 | 原因与处理 |
无法使用该功能 | 功能白名单未开通，联系腾讯云支持。 |
提交时提示 CAM 授权失败 | TCR_QCSRole 未绑定 QcloudAccessForAgsRoleInTCR 预设策略；由主账号（或具备 CAM 权限的子账号）在弹窗中完成授权，或在 CAM 控制台手动为 TCR_QCSRole 绑定该策略。 |
推送镜像后未触发自动预热 | 确认镜像预热的触发规则已配置成功，并检查实际推送镜像的命名空间、仓库名称以及版本 Tag 是否符合触发规则。 |
