文档中心

容器服务

请输入

VCI 镜像缓存

使用自动镜像缓存创建 VCI 实例

在创建容器（Container）过程中，镜像拉取往往耗时较长，目前弹性容器实例支持使用自动镜像缓存方案，加速 VCI 实例的创建过程。

使用限制

使用自动镜像缓存方案加速创建 VCI 实例有如下使用限制。

限制项	限制说明
镜像缓存盘（云盘）	默认仅提供 40 GiB 的存储空间，若识别到目标容器镜像所需要的缓存容量空间超过 40 GiB 时，需要单独指定所需的存储空间，否则镜像缓存可能会创建失败。
镜像缓存快照	镜像缓存有效期为 15 天，过期后再次使用镜像创建云盘的耗时会变长，且可能导致云盘创建失败。说明建议预先基于该镜像缓存手动创建云盘并触发云盘对快照数据进行预热缓存。预热缓存需在使用镜像缓存的目标地域和可用区中进行。
镜像缓存能力限制	自动镜像缓存功能默认不开启，需要通过特定的 Annotation（注解）进行使能。使用自动创建的镜像缓存创建 VCI 实例时，VCI 实例的系统盘容量必须大于等于所匹配/使用的镜像缓存大小。自动镜像缓存能力暂不提供 API。使用自动镜像缓存时，需要提前通过创建少量的 Pod 来触发和创建自动镜像缓存。待自动创建的镜像缓存状态为 [Ready.Ok] 后，即可使用其大批量创建业务 Pod。自动创建的镜像缓存，若一直未被 Pod 使用，则最长保留 15 天。如果创建 VCI 实例过程中使用镜像缓存，则会刷新过期时间为「匹配时间 + 15 天」。如果连续 15 天未使用，会自动清理。除了正在删除中的镜像缓存（状态为 [deleting,*]），每个火山引擎账号（含子用户）最多支持存在 20 个镜像缓存，超过后无法创建新的镜像缓存。您可以删除无用的镜像缓存，或在配额中心申请提升配额。详细操作，请参见配额查看和申请。 VCI 支持弹性块存储（EBS）的极速可用能力，缩短镜像缓存从创建到可使用的时间。该能力目前为独立的邀测能力，如需使用，请额外提交邀测申请。说明若首次申请试用 VCI 镜像缓存能力，且同时需要使用 EBS 极速可用能力，则在同一个邀测申请中提交试用说明即可。

使用方法

步骤一：准备容器镜像

准备创建 VCI 实例时使用的容器镜像。支持使用火山引擎镜像仓库（CR）中的镜像，也支持使用第三方镜像仓库中的镜像。

本文以使用 CR 中的镜像为例。上传镜像到 CR 的操作，请参见推送和拉取镜像。

步骤二：（可选）自动缓存及预热镜像

创建 VCI 实例前请确认需要使用的容器镜像是否为新的镜像。若为新镜像，则需要通过添加提前完成镜像的缓存和预热。

说明

新的镜像是指镜像名称、镜像版本、镜像层数据等与已有的镜像不一致的容器镜像。

建议先创建少量的 Pod 实例来触发和完成自动镜像缓存的创建。下文以创建包含 1 个 Pod 实例，且以弹性容器实例方式部署的无状态负载（VCI Deployment）为例。详细的操作说明，请参见指定容器 vCPU 和内存创建实例。

控制台方式创建

YAML 方式创建

创建 VCI 业务集群。

创建无状态负载，其中部分参数，按如下说明配置。

a. 配置基本信息时：算力类型选择弹性容器实例 VCI。

b. 配置容器配置时：选择已准备好的新镜像。

c. 配置高级配置时：实例注解处，添加 Annotation：vci.vke.volcengine.com/enable-auto-create-imc:"true"。

注意

VCI 默认仅提供 40 GiB 的存储空间用于镜像缓存，若识别到目标容器镜像所需要的缓存容量空间较大时，需要在本步骤添加额外的 Annotation：vci.vke.volcengine.com/auto-imc-disk-size："具体容量大小"（单位为 GiB）来指定所需的镜像缓存盘大小，例如需要 80 GiB 容量，则 Annotation 为vci.vke.volcengine.com/auto-imc-disk-size："80"。

单击确定，创建 VCI Deployment。

步骤三：确认镜像缓存可用

通过弹性容器实例提供的 OpenAPI：ListImageCaches，查询当前火山引擎账号下所有的镜像缓存文件信息。

注意

仅当自动创建的镜像缓存状态为 [Ready.Ok] 时，才能正常匹配和使用自动创建的镜像缓存来创建 VCI 实例。

步骤四：使用自动镜像缓存加速创建 VCI 实例

确认待使用的镜像缓存可用后，即可通过该镜像缓存，大批量创建 VCI 实例相关的 Pod。有如下两种使用方式：

说明

为保证使用镜像缓存创建的 VCI 实例正常运行，请在创建 VCI 实例时，添加 Pod Annotation 手动指定系统盘大小，满足存储镜像缓存和部署 VCI 系统组件所需的空间。更多信息，请参见 Pod Annotation 说明。

其中 Annotation Key 为vci.vke.volcengine.com/desired-system-storage，Annotation Value 请根据如下原则设置：

自动匹配镜像缓存：镜像大小 * （2~2.5倍）。例如您创建 VCI 实例时选择的镜像大小为 20 GiB，那么您需要指定的系统盘大小为 40 GiB~50 GiB。

手动指定镜像缓存：镜像缓存大小 + 20 GiB。例如您的镜像缓存大小为 60 GiB，那么您需要指定的系统盘大小为 80 GiB。

手动指定系统盘大小的功能，目前处于邀测阶段，请提交邀测申请后使用。

自动匹配镜像缓存

手动匹配镜像缓存

创建 VCI 实例时，选择已经完成自动缓存的镜像。详细操作，请参见创建实例。

系统根据匹配策略自动匹配最优的镜像缓存来创建 VCI 实例。自动匹配镜像缓存策略，请参见使用镜像缓存。

说明

若未执行步骤二操作，则需要在 VCI 实例的spec·template·metadata下添加特定的 Annotation：vci.vke.volcengine.com/enable-auto-create-imc:"true"，开启自动镜像缓存。