容器服务
容器服务
文档指南
请输入
- 文档首页
容器服务弹性容器实例 VCI用户指南VCI 镜像缓存使用手动镜像缓存创建 VCI 实例
复制全文
下载 pdf使用手动镜像缓存创建 VCI 实例
文档反馈
问问助手在创建容器（Container）过程中，镜像拉取往往耗时较长，目前弹性容器实例支持使用手动镜像缓存方案加速创建 VCI 实例。
使用限制
- 除了正在删除中的镜像缓存（状态为 [Deleting,*]），每个火山引擎账号（含子用户）最多支持存在 20 个镜像缓存，超过后无法创建新的镜像缓存。您可以删除无用的镜像缓存，或 提交工单 申请提升配额。
- VCI 支持弹性块存储（EBS） 的极速可用能力，缩短镜像缓存从创建到可使用的时间。该能力目前在 EBS 侧处于 邀测 阶段，如需使用，请联系您的火山引擎客户经理。
使用方式
步骤一：准备容器镜像
步骤二：创建镜像缓存
- 登录 容器服务控制台。
- 在左侧导航栏，选择 弹性容器实例 > 镜像缓存，然后单击 创建镜像缓存。
- 在 创建镜像缓存 页面，根据系统提示设置 镜像缓存配置。
- 配置项说明基本配置名称根据系统提示，设置镜像缓存名称。同一地域（Region）内镜像缓存名称须唯一。私有网络子网说明默认使用第一个子网来创建镜像缓存所需的临时 Pod 资源。安全组为保证镜像缓存及相关功能的正常运作，需关联上述所选 VPC 下的安全组。缓存大小设置镜像缓存的大小，默认为 40 GiB，取值范围为 40~500 GiB。容器镜像配置容器镜像选择或填写制作镜像缓存所需的具体容器镜像，支持如下两种镜像来源：
- 火山引擎镜像仓库（CR）：直接输入 CR 镜像地址或单击 选择自有镜像，从右侧弹出的面板中选择目标镜像仓库实例下的镜像。
注意选中目标 CR 镜像后还需要选择 镜像版本，不选择则默认拉取 Tag 为latest的镜像，若无latest Tag 的镜像时，创建镜像缓存将失败。- 第三方镜像仓库：直接输入第三方镜像仓库地址，输入的镜像地址可以包含 Tag（例如：example.com/namespace/repository:v1），也可以将 Tag 填写到 镜像版本 输入框中。
单击 添加容器镜像 支持添加多个镜像。镜像仓库配置镜像仓库访问凭证所添加的容器镜像为 私有 镜像时，单击 添加访问凭证，配置镜像仓库访问凭证。- 访问域名：不带http://或https://前缀的镜像仓库域名，例如cr-cn-beijing.volces.com。
- 用户名：访问镜像仓库的用户名。
- 密码：镜像仓库用户名对应的密码。
高级配置注解为镜像缓存配置注解（Annotation）。目前仅支持配置如下两个 Annotation，用于为镜像缓存配置分账：- vci.volcengine.com/image-cache-resource-tags：为镜像缓存绑定标签，用于从标签维度对镜像缓存进行分账。自定义标签的要求如下：
- 支持的格式为 String。
- 每个标签由key:value格式的键值对组成，多个标签中间以英文逗号（,）分隔，例如k1:v1,k2:v2，表示为该镜像缓存设置两个标签，分别为k1:v1和k2:v2。
- 标签 key 要求如下：
- 不能以任何大小写形式的volc:开头。
- 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。
- 长度限制为 1～128 个字符。
- 标签 value 要求如下：
- 可以为空。
- 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。
- 长度不超过 256 个字符。
- 单个镜像缓存最多支持 50 个标签。
- 镜像缓存已有相同标签 key 的情况下，通过该 Annotation 重复绑定标签 key 时，会覆盖原来的标签 value。
- 标签 key 的前后和标签 value 的前后均不允许输入空格。
- vci.volcengine.com/image-cache-project-name：为镜像缓存绑定项目，用于从项目维度对镜像缓存进行分账。输入的项目名称有如下注意事项：
- 输入不存在的项目名称，则镜像缓存创建报错。
- 未配置该 Annotation，即未绑定项目时，镜像缓存默认使用 default 项目。
增量制作镜像缓存勾选 启用 后，指定已有的 基础镜像缓存 并开启镜像缓存增量制作。新创建的镜像缓存将复用所指定镜像缓存的镜像层，加快新镜像缓存的创建速度。
- 单击 下一步：配置确认，确认镜像缓存配置信息并阅读服务条款。
- 确认信息并对服务条款无异议后勾选 我已阅读并同意《容器服务专用服务条款》 ，单击 确定，创建镜像缓存。
说明
创建镜像缓存成功后，默认的有效期为 15 天。如果创建 VCI 实例过程中使用镜像缓存，则会刷新过期时间为「匹配时间 + 15天」。如果连续 15 天未使用，会自动清理。如需修改镜像缓存到期时间，请调用 API：UpdateImageCacheRetentionDays 修改。
步骤三：使用手动镜像缓存加速创建 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.vke.volcengine.com/image-cache-id指定的镜像缓存状态，进行前置校验。请确保指定的镜像缓存处于 可用 或 [Ready.Ok] 状态，否则将报错，无法成功创建 VCI Pod。
相关文档
最近更新时间：2026.08.04 14:07:16
这个页面对您有帮助吗？
有用
有用
无用
无用