镜像预热用于将镜像提前分发到目标容器服务集群的中心缓存节点或业务节点，降低集中发布时的镜像拉取压力，缩短容器启动等待，适用于集中版本发布、集群节点扩容前、GPU 大镜像冷启动等需要降低拉取耗时的场景。您可以通过创建预热策略，指定镜像范围、目标集群与触发方式，由镜像仓库自动创建并执行预热任务。 ## 使用限制 * 镜像预热仅标准版标准实例支持，远端代理仓不支持。 * 仅在容器服务 P2P 组件中关联的镜像仓库实例支持本功能，P2P 组件中关联镜像仓库实例的方法参见 [p2p-accelerator](https://docs.volcengine.com/docs/vke/p2p-accelerator-add-on)。 ## 前提条件 ### 容器服务已在容器服务完成 P2P 镜像加速配置，操作详情参见 [配置 P2P 镜像加速](https://docs.volcengine.com/docs/vke/P2P-acceleration-solution)，并且 P2P 组件中已关联本镜像仓库实例。 ### 镜像仓库 * 已创建命名空间，操作详情参见 [镜像仓库命名空间](https://docs.volcengine.com/docs/cr/create-a-namespace)。 * 已创建 OCI 制品仓库，操作详情参见 [创建 OCI 制品仓库](https://docs.volcengine.com/docs/cr/Creating_OCI_artifact_repositories?lang=zh)。 * 已推送至少一个镜像版本至已创建的 OCI 制品仓库，操作详情参见 [推送和拉取制品](https://docs.volcengine.com/docs/cr/Push_and_pull_artifacts)。 ## 操作步骤 ### 第一步：创建预热策略 1. 登录目标实例。 1. 登录 [镜像仓库控制台](https://console.volcengine.com/cr)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏，单击 ** 实例列表 \> 标准实例**，找到目标实例并单击 **进入实例。** 2. 在左侧导航栏，单击 **分发加速 \> 镜像预热。** 3. 单击 **创建预热策略**，配置预热策略参数。 * **基本信息** |**参数** |**说明** | |---|---| |策略名称 |自定义预热策略的名称。 | * **预热配置** |**参数** |**说明** | |---|---| |实例 |默认展示预热策略所属的镜像仓库实例的名称。 | |命名空间 |选择实例下需要预热的命名空间，支持多选。 | |仓库 |选择需要预热的 OCI 制品仓库范围，取值如下：

* **全部**：同步指定命名空间下的全部 OCI 制品仓库。

* **正则匹配**：通过正则规则匹配需要同步的 OCI 制品仓库。常用的正则匹配示例参见 [正则匹配示例](https://www.volcengine.com/docs/6420/2488135?lang=zh)。 | |镜像版本 |选择需要预热的镜像版本（Tag）范围，取值如下：

* **全部**：预热命名空间内所选仓库下的全部镜像版本。

* **正则匹配**：通过正则规则匹配需要预热的镜像版本。常用的正则匹配示例参见 [正则匹配示例](https://www.volcengine.com/docs/6420/2488135?lang=zh)。 | |目标集群 |选择镜像预热要分发的 VKE 集群。预热任务创建后，镜像仓库会把镜像分发到该集群下指定的目标节点类型。

说明

下拉菜单仅展示支持在本实例中创建预热策略的容器服务集群。预热策略对容器服务的要求参见本文的 使用限制 和 前提条件。

| |目标节点类型 |选择镜像在容器服务集群内的分发范围。预热任务执行时，镜像仓库会把镜像分发到此处指定的节点上，取值如下：

* **中心缓存节点**：镜像分发到 P2P 中心缓存节点，业务节点启动时从中心缓存拉取。适用于多集群共用镜像、节点频繁扩缩容的场景。

* **部分业务节点**：镜像提前缓存至业务节点本地，Pod 启动时直接从本地读取，无需经过中心缓存节点。若目标集群同时存在中心缓存节点，中心缓存节点也会保留一份缓存。适用于镜像体积大、对 Pod 冷启动时延要求苛刻、需完全避免远端回源的场景。 | |目标平台 |当目标镜像为多架构镜像时，选择需要预热的镜像架构，取值如下：

* **linux/amd64**：适用于 x86_64 架构的节点。

* **linux/arm64**：适用于 ARM 架构的节点。 | * **预热策略** |**参数** |**说明** | |---|---| |策略状态 |预热策略的启用状态，默认启用。停用后策略不再产生新任务，已在途任务不受影响。 | |触发方式 |选择预热任务的触发方式，取值如下：

* **事件触发**：每次镜像推送成功后自动创建一个预热任务，无需额外配置。

* **定时触发**：按指定时间周期性创建预热任务，需配置 **首次触发时间 ** 和 **触发频率**。

* **首次触发时间**：首次触发预热任务的时间，需晚于当前时间（精确到秒）。

* **触发频率**：预热任务触发的频率，每隔 **触发频率**（1~24 小时）创建一次预热任务。

* **手动触发**：策略不自动创建任务，需在控制台预热策略列表中单击 **操作** 列的 **手动触发**，每次单击创建一个预热任务。 | |单节点超时 |单个节点执行预热的超时时间，范围 1~1440 分钟，默认 10 分钟。超时后节点判定为失败，并按 **重试次数 ** 重试。 | |重试次数 |单节点预热失败后自动重试的次数，范围 1~10 次，默认 3 次。 | ### 第二步：触发预热任务预热策略创建完成后，支持通过以下两种方式触发预热任务。 * **自动触发** 如果创建策略时 **触发方式 ** 为 **定时触发** 或 **事件触发**，系统将在满足触发条件时自动发起预热任务，无需手动操作。 * **手动触发** 如果创建策略时 **触发方式 ** 为 **手动触发**，需要在控制台手动触发预热任务。 1. 在 **分发加速 \> 镜像预热** 页面，单击目标预热策略 **操作** 列下的 **手动触发**。 2. 在二次确认页面，单击 **确定**。 ### 第三步：查看预热任务登录预热策略详情页后，可在 **任务执行记录 ** 页签查看所有预热任务的执行情况。 1. 在 **分发加速 \> 镜像预热** 页面，单击目标策略名称，进入策略详情页。 2. 单击 **任务执行记录** 页签，在任务列表中，查看各预热任务的执行情况。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fe1b3e5c39e4ac53ea8e375ae3f61e41.png) |**参数** |**说明** | |---|---| |任务 ID |预热任务的 ID，由系统自动生成。支持在搜索框中按完整 ID 搜索任务。 | |来源策略 |触发该任务的预热策略名称。 | |触发方式 |任务的触发方式，取值包括 **手动触发**、**定时触发**、**事件触发**。

* **事件触发**：每次镜像推送成功后自动创建一个预热任务。

* **定时触发**：按指定时间周期性创建预热任务。

* **手动触发**：在控制台预热策略列表中单击 **操作** 列的 **手动触发**，每次单击创建一个预热任务。 | |镜像 |本次任务涉及的镜像处理的结果，展示预热成功、失败、取消的镜像数。 | |目标集群 |本次预热任务的目标容器服务集群的名称。 | |目标节点类型 |预热镜像分发到的节点类型，取值为 **中心缓存节点 ** 或 **部分业务节点**。

* **中心缓存节点**：镜像分发到 P2P 中心缓存集群，业务节点启动时从中心缓存拉取，不占用业务节点本地磁盘。

* **部分业务节点**：镜像提前缓存至业务节点本地，Pod 启动时直接从本地读取，无需经过中心缓存节点。 | |状态 |任务当前状态，取值如下：

* **等待执行**：任务已创建并通过前置校验，等待调度资源。

* **调度中**：系统正在解析目标节点并分配执行批次。

* **执行中**：至少一个执行批次已下发到节点。

* **成功**：镜像预热完成。

* **失败**：前置校验、调度或执行结果达到失败条件，可在 **操作 ** 列单击 **重试** 重新发起任务。

* **已取消**：由用户主动终止、来源策略被删除或目标集群预热能力被关闭导致的提前结束。 | |创建时间 |任务的创建时间。 | |耗时 |任务执行的时长。 | |操作 |可对任务执行的操作，取决于任务当前状态：

* 任务状态为 **等待执行** 时，可单击 **终止** 取消任务。

* 任务状态为 **失败** 时，可单击 **重试** 重新发起任务，重试会生成新的任务记录。 | 3. 单击目标任务 ID，查看预热任务详情。 * **任务信息** |**参数** |**说明** | |---|---| |任务 ID |任务 ID。 | |状态 |任务当前状态，取值为 **等待执行**、**调度中**、**执行中**、**成功**、**失败** 或 **已取消**。 | |来源策略 |触发该任务的预热策略名称。 | |触发方式 |任务的触发来源，取值为 **手动触发**、**定时触发** 或 **事件触发**。 | |目标集群 |本次预热任务的目标容器服务集群的名称。 | |目标节点类型 |取值为 **中心缓存节点** 或 **部分业务节点**。 | |创建时间 |任务的创建时间。 | |开始时间 |任务开始执行的时间。 | |结束时间 |任务执行结束的时间（成功、失败或取消）。 | |耗时 |任务从开始执行到结束所经历的时间。 | |原因 |任务失败时展示失败原因。 | |告警 |任务执行期间产生的告警信息。 | * **镜像执行概况** |**参数** |**说明** | |---|---| |镜像总数 |本次预热任务涉及的镜像总数量。 | |已完成 |已完成预热的镜像数量，包含成功与失败。 | |成功 |预热成功的镜像数量。 | |失败 |预热失败的镜像数量。 | |执行中 |正在预热中的镜像数量。 | |已取消 |被取消的镜像数量。 | * **镜像预热记录** 当任务整体为失败，但部分镜像预热成功时，可在本列表按状态筛选失败镜像，结合 **任务信息** 中的 **原因 ** 字段快速定位个别镜像的拉取问题。 |**参数** |**说明** | |---|---| |镜像 / Digest 摘要 |预热的镜像地址及 Digest 标识。 | |镜像格式 |镜像的格式类型。 | |目标节点类型 |取值为 **中心缓存节点** 或 **部分业务节点**。 | |目标平台 |镜像对应的目标运行平台。 | |状态 |该镜像的预热状态，支持按状态筛选。 | |创建时间 |该镜像预热记录的创建时间。 | |耗时 |该镜像预热所经历的时间。 |