文档

管理镜像缓存

更新时间:

镜像缓存可以加速拉取镜像,减少ECI实例启动耗时。本文介绍如何创建、查询、更新和删除镜像缓存。

创建镜像缓存

您可以通过控制台或者OpenAPI手动创建镜像缓存。

说明

ECI支持自动创建镜像缓存。在创建ECI实例时,如果开启了自动匹配镜像缓存,则在未匹配到镜像缓存的情况下,系统将自动创建镜像缓存。

注意事项

  • 创建镜像缓存涉及资源计费。建议您提前了解相关计费信息。更多信息,请参见镜像缓存计费

  • 创建镜像缓存前,您需要评估待缓存镜像的总大小,如果镜像总大小超过设置的缓存大小,将会创建失败。

  • 创建镜像缓存时,系统将自动创建一个ECI实例和一块云盘用于中转创建镜像缓存。创建过程中请勿删除ECI实例和云盘,否则镜像缓存将创建失败。

  • 创建镜像缓存将生成对应的快照。请勿删除快照,否则镜像缓存将会失效。

通过OpenAPI创建

您可以调用CreateImageCache接口来创建镜像缓存,主要参数说明如下表所示。更多信息,请参见CreateImageCache

名称

类型

示例值

描述

RegionId

string

cn-hangzhou

地域ID。

SecurityGroupId

string

sg-uf66jeqopgqa9hdn****

安全组ID。

VSwitchId

string

vsw-uf6h3rbwbm90urjwa****

交换机ID。

ImageCacheName

string

testcache

镜像缓存名称。

Image.N

array

registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

用于制作镜像缓存的容器镜像。

ImageCacheSize

integer

20

镜像缓存大小。默认为20 GiB。

RetentionDays

integer

7

镜像缓存保留时长,过期将会被清理。单位为:天。

AutoMatchImageCache

boolean

false

是否开启镜像缓存复用。开启后,新创建的镜像缓存可以复用已有镜像缓存的镜像层,加快镜像缓存的制作速度。默认为false。

Flash

boolean

true

是否开启极速镜像缓存功能。开启后,可以加速镜像缓存创建。默认为false。

说明

创建镜像缓存时,支持设置AcrRegistryInfo相关参数,通过ACR企业版来免密拉取镜像。更多信息,请参见配置ACR企业版免密

通过控制台创建

  1. 弹性容器实例控制台镜像缓存页面,单击创建镜像缓存

  2. 在弹出页面,配置相关参数。

    相关参数说明如下:

    • 基本参数:设置地域、可用区、专有网络和安全组等参数,用于创建中转实例。

      重要

      如果镜像需要公网拉取,在专有网络没有配置NAT网关的情况下,请绑定弹性公网IP。

    • 镜像缓存:输入镜像缓存名称,选择镜像地址和版本号,按需设置大小和保留时长。

    • 镜像仓库访问凭证:如果镜像是私有镜像,请填写镜像仓库的地址、访问用户名和密码。

  3. 选中服务协议,单击确认创建,并根据提示完成后续操作。

  4. 镜像缓存页面查看创建结果。

    状态列显示创建进度,当状态变为创建完成时,表示镜像缓存创建成功。单击镜像缓存ID,可以打开详情页面,查看基本信息和相关事件。

查询镜像缓存

创建镜像缓存后,您可以查询镜像缓存信息。当镜像缓存状态为创建完成(Ready)时,可以使用该镜像缓存。

查询方式如下:

  • 调用DescribeImageCaches接口可以查询镜像缓存信息。更多信息,请参见DescribeImageCaches

  • 弹性容器实例控制台镜像缓存页面查看镜像缓存的名称、状态等信息,单击镜像缓存ID可以查看事件等详细信息。

更新镜像缓存

对于状态为创建完成(Ready)或者UpdateFailed(更新失败)的镜像缓存,支持调用UpdateImageCache接口来更新镜像缓存,包括更新容器镜像、保留时长、镜像仓库信息等。更多信息,请参见UpdateImageCache

删除镜像缓存

镜像缓存对应一份快照,保留镜像缓存需要支付相应的快照费用。对于不再使用的镜像缓存,如果在创建时未设置保留时长,建议您及时手动删除。

说明

自动创建的镜像缓存由阿里云管理,在一定时长后会被自动删除。

  • 对于自动创建后从未使用过的镜像缓存,7天后会被自动删除。

  • 对于自动创建后使用过的镜像缓存,当距离上一次使用的时间超过30天时,会被自动删除。

删除方式如下:

  • 调用DeleteImageCache接口可以删除镜像缓存。更多信息,请参见DeleteImageCache

  • 弹性容器实例控制台镜像缓存页面,选中目标镜像缓存,单击底部的删除镜像缓存即可删除。