You need to enable JavaScript to run this app.
导航
使用手动镜像缓存创建 VCI 实例
最近更新时间:2024.12.09 20:46:13首次发布时间:2023.02.07 19:17:04

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

说明

邀测·申请试用】:该功能目前处于邀测阶段,如需使用,请提交申请。

使用限制

  • 除了正在删除中的镜像缓存(状态为 [Deleting,*]),每个火山引擎账号(含子用户)最多支持存在 20 个镜像缓存,超过后无法创建新的镜像缓存。您可以删除无用的镜像缓存,或 提交工单 申请提升配额。
  • VCI 支持弹性块存储(EBS) 的极速可用能力,缩短镜像缓存从创建到可使用的时间。该能力目前为独立的邀测能力,如需使用,请额外提交 邀测申请

    说明

    若首次申请试用 VCI 镜像缓存能力,且同时需要使用 EBS 极速可用能力,则在同一个 邀测申请 中提交试用说明即可。

使用方式

步骤一:准备容器镜像

准备创建 VCI 实例时使用的容器镜像。支持使用火山引擎镜像仓库(CR)中的镜像,也支持使用第三方镜像仓库中的镜像。上传镜像到 CR 的操作,请参见 推送和拉取镜像

步骤二:创建镜像缓存

  1. 登录 容器服务控制台
  2. 在左侧导航栏,选择 弹性容器实例 > 镜像缓存,然后单击 创建镜像缓存
  3. 创建镜像缓存 页面,根据系统提示设置 镜像缓存配置
    配置项说明
    基本配置
    名称根据系统提示,设置镜像缓存名称。同一地域(Region)内镜像缓存名称须唯一。
    私有网络选择镜像缓存所属的私有网络(VPC)。私有网络为镜像缓存提供一个隔离的、自主配置和管理的虚拟网络环境。若无可用私有网络,可参考 创建私有网络 进行创建。

    子网

    选择上述所选 VPC 下的子网,为镜像缓存提供子网网段。若无可用子网,可单击 创建子网 创建。详细操作,请参见 创建子网

    说明

    默认使用第一个子网来创建镜像缓存所需的临时 Pod 资源。

    安全组为保证镜像缓存及相关功能的正常运作,需关联上述所选 VPC 下的安全组。
    缓存大小设置镜像缓存的大小,默认为 40 GiB,取值范围为 40~500 GiB。
    容器镜像配置

    容器镜像

    选择制作镜像缓存所需的容器镜像,即 步骤一 中已准备的容器镜像。

    • 第三方镜像:直接输入第三方镜像仓库地址(包括镜像 Tag),例如:example.com/namespace/repository:v1
    • CR 中的镜像:单击 选择自有镜像,从右侧弹出的面板中选择目标镜像仓库实例下的镜像。
      选中目标 CR 镜像后还需要选择 镜像版本,不选择则默认拉取 Tag 为latest的镜像。
    镜像仓库配置

    镜像仓库访问凭证

    所选的容器镜像为 私有 镜像时,单击 添加访问凭证,配置镜像仓库访问凭证。

    • 访问域名:不带http://https://前缀的镜像仓库域名,例如cr-cn-beijing.volces.com
    • 用户名:访问镜像仓库的用户名。
    • 密码:镜像仓库用户名对应的密码。
    预热配置

    预热配置

    镜像缓存对应的弹性块存储(EBS)快照预热策略配置。勾选 启用 后,还需设置:

    • 可用区:镜像缓存对应的弹性块存储(EBS)快照预热可用区。可选的可用区为 子网 中指定子网对应地域的可用区,支持多选可用区。
    • 有效时长:镜像缓存对应 EBS 快照的预热保留时长。单位为天。
  4. 单击 下一步:配置确认,确认镜像缓存配置信息并阅读服务条款。
  5. 确认信息并对服务条款无异议后勾选 我已阅读并同意《容器服务专用服务条款》 ,单击 确定,创建镜像缓存。

    说明

    创建镜像缓存成功后,默认的有效期为 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 实例时,选择已经完成缓存的镜像。详细操作,请参见 创建实例
系统根据匹配策略自动匹配最优的镜像缓存来创建 VCI 实例。自动匹配镜像缓存策略,请参见 使用镜像缓存

手动指定镜像缓存

在 VCI 实例的spec·template·metadata下添加特定的 Annotation:vci.vke.volcengine.com/image-cache-id:imc-3uqroqkx0i3j********,指定镜像缓存 ID。详细操作,请参见 创建实例

VCI 实例在创建过程中,会直接使用指定的镜像缓存来创建。

注意

弹性容器实例会对通过vci.vke.volcengine.com/image-cache-id指定的镜像缓存状态,进行前置校验。请确保指定的镜像缓存处于 可用[Ready.Ok] 状态,否则将报错,无法成功创建 VCI Pod。

日常管理

镜像缓存有配额管理机制,限制一个火山引擎账号下可允许保留的最大的镜像缓存数量。您可以手动对已有的镜像缓存进行管理。建议策略如下:

  • 已经创建完成且使用过的镜像缓存,如果后续不再使用,可通过调用 OpenAPI:DeleteImageCache 删除镜像缓存。
  • 创建失败或删除失败(状态为 Failed )的镜像缓存,也可通过调用 OpenAPI:DeleteImageCache 进行删除。
  • 如需更新镜像缓存,可通过调用 OpenAPI:UpdateImageCache 进行更新。

镜像缓存也支持通过 容器服务控制台 进行 删除更新。详细操作,请参见 管理镜像缓存

API 文档