Agent 启动时需要拉取镜像，镜像缓存可以缩短镜像准备时间，加速实例启动。镜像缓存属于当前 Workspace，在该 Workspace 内可见与管理。
镜像缓存功能当前处于公测阶段，公测期间暂不计费。正式商用后，镜像缓存将开始计费。
准备工作
创建镜像缓存前，需满足以下条件：
-
已创建 Workspace，并进入目标 Workspace。
-
源镜像已推送至容器镜像服务 ACR 的镜像仓库，可获取镜像版本（Tag）和 Digest。镜像缓存按镜像内容的 Digest 匹配复用。同一普通 Tag 暂不支持覆盖推送，
latest除外。 -
拉取源镜像前，已在 ACR 为当前 Workspace 配置公网白名单或 VPC 访问。
创建新镜像缓存前，需授予 AgentCore 读取所选源镜像的权限。该授权与 Agent 的运行执行角色无关。如果权限不足，请按控制台提醒前往授权；完成后刷新授权状态再继续。
ACR 侧的网络访问配置需在拉取源镜像前完成，公网与 VPC 两条拉取路径的配置要求如下：
|
拉取路径 |
ACR 侧配置 |
创建面板开关 |
|
公网 |
为当前 Workspace 配置公网白名单 |
允许默认网卡访问公网，默认开启 |
|
VPC |
为当前 Workspace 配置 VPC 访问 |
允许访问 VPC，默认关闭，需开启 |
创建面板会提示当前 Workspace 的公网出口 IP。首次配置公网白名单时，可先打开创建面板获取该 IP，在 ACR 完成白名单配置后再提交创建。
创建面板的网络选择仅用于本次镜像拉取与转存，不会保存为 Agent 的网络配置。
创建镜像缓存
完成准备工作后，在目标 Workspace 的 镜像缓存 页面创建镜像缓存。
-
登录 AgentCore 控制台。
-
进入目标 Workspace 的 镜像缓存 页面。
-
单击 创建镜像缓存。
-
在创建面板中配置以下参数。
配置项
是否必填
说明
Workspace
是
只读，显示当前 Workspace。
地域
是
只读，显示当前 Workspace 所在地域。支持的地域范围以控制台实际显示为准。
容器镜像实例
是
选择源镜像所在的 ACR 实例。
镜像仓库
是
选择源镜像仓库。需先选择 容器镜像实例。
镜像版本
是
选择目标镜像版本。需先选择 镜像仓库。版本列表展示镜像版本、Digest、镜像大小和最近推送时间，并支持按版本搜索和刷新。
允许默认网卡访问公网
否
默认开启。指定本次镜像拉取与转存是否允许通过默认网卡访问公网。
允许访问 VPC
否
默认关闭。指定本次镜像拉取与转存是否允许访问 VPC。
-
单击 创建。
提交创建后，可在 Workspace 的 镜像缓存 页面查看镜像缓存及其状态。创建通常需要几分钟，期间已开启镜像缓存的 Agent 仍可通过冷启动创建实例。
|
状态 |
说明 |
|
创建中 |
正在准备镜像缓存，期间已开启镜像缓存的 Agent 仍可通过冷启动创建实例。 |
|
可用 |
缓存已就绪，已开启镜像缓存的 Agent 后续新建实例自动使用缓存加速。 |
|
异常 |
缓存创建失败，已开启镜像缓存的 Agent 仍可通过冷启动创建实例；可在缓存详情中查看失败原因并重试。 |
查看镜像缓存
在 Workspace 的 镜像缓存 页面查看已创建的镜像缓存，可执行以下操作：
-
在 搜索镜像名称或源镜像地址 框中输入关键字后搜索。
-
按状态筛选镜像缓存，默认选中 全部状态。可按 创建中、可用 或 异常 筛选。
-
刷新列表以获取最新状态。
列表展示镜像及版本、状态、使用缓存的 Agent 和操作。操作提供 详情 和 删除。
查看缓存详情
单击列表中的 详情，查看缓存详情，包括源镜像、Digest、缓存大小、创建时间、状态说明及使用此缓存的 Agent。Digest 用于唯一标识该镜像内容。缓存状态为 异常 时，可在状态说明中查看失败原因并重试。
在 Agent 中使用镜像缓存
镜像缓存开关在 Agent 级配置。在创建或编辑 Agent 时，选定镜像版本后可开启镜像缓存。已有匹配且可用的缓存时直接复用；没有可用缓存时随 Agent 准备缓存，通常需要几分钟，期间实例可以冷启动。
开启镜像缓存时，如果权限不足，页面会显示授权提醒，可前往授权并刷新授权状态；未完成授权时，提交会被阻止。完成授权并刷新成功后，提醒消失，即可正常提交。
开启镜像缓存不会主动重建已有实例，后续新建、扩容或因其他原因重建的实例使用缓存。关闭镜像缓存后，平台会重建相关运行实例。重建完成且实例不再使用该缓存前，不能删除缓存。
删除镜像缓存
只有当前 Workspace 内没有 Agent 开启并关联该缓存，且没有实例仍在使用该缓存时，才能删除。先关闭相关 Agent 的镜像缓存开关，等待实例重建完成并释放使用；即使使用缓存的 Agent 数量为 0，也不能据此直接判断可删除，应以控制台的删除可用状态及原因提示为准。
在该缓存的 详情 或列表中发起 删除，确认后从当前 Workspace 删除该缓存。