全部产品
Search
文档中心

弹性容器实例:管理镜像缓存

更新时间:Nov 03, 2022

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

创建镜像缓存

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

说明

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

通过OpenAPI创建

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

名称

类型

示例值

描述

RegionId

String

cn-hangzhou

地域ID。

ImageCacheName

String

testcache

镜像缓存名称。

Image.N

RepeatList

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

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

SecurityGroupId

String

sg-uf66jeqopgqa9hdn****

安全组ID。

VSwitchId

String

vsw-uf6h3rbwbm90urjwa****

交换机ID。

ImageCacheSize

Integer

20

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

RetentionDays

Integer

7

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

AutoMatchImageCache

Boolean

false

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

Flash

Boolean

true

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

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

名称

类型

示例值

描述

AcrRegistryInfo.N.Domain.N

String

test****-registry.cn-beijing.cr.aliyuncs.com

ACR企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名,多个以半角逗号分隔。

AcrRegistryInfo.N.InstanceName

String

test****

ACR企业版实例的名称。

AcrRegistryInfo.N.InstanceId

String

cri-nwj395hgf6f3****

ACR企业版实例ID。

AcrRegistryInfo.N.RegionId

String

cn-beijing

ACR企业版实例所属地域。

以Python SDK为例,使用ACR企业版免密拉取镜像来创建镜像缓存的配置示例如下:

from aliyunsdkcore.client import AcsClient
from aliyunsdkeci.request.v20180808.CreateImageCacheRequest import CreateImageCacheRequest

client = AcsClient('<accessKeyId>', '<accessSecret>', '<region-Id>')

request = CreateImageCacheRequest()
request.set_accept_format('json')

request.set_SecurityGroupId("sg-2zeh4cev9y7ulbr****")
request.set_VSwitchId("vsw-2zejlv7xjnw61w6zr****")
request.set_ImageCacheName("acr-test-cache")
request.set_Images([
    "****-registry-vpc.cn-beijing.cr.aliyuncs.com/eci_test/nginx:1.0",
])
request.set_AcrRegistryInfos([
  {
    "InstanceId": "cri-nwj395hgf6f*****",
    "RegionId": "cn-beijing"
  }
])

response = client.do_action_with_exception(request)
print(str(response, encoding='utf-8'))

通过控制台创建

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

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

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

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

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

查询镜像缓存

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

查询方式如下:

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

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

更新镜像缓存

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

删除镜像缓存

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

说明

自动创建的镜像缓存快照由阿里云管理,如果在30天内未使用,将被自动删除。

删除方式如下:

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

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