使用镜像缓存加速ACS Pod启动

功能介绍

在运行容器前，ACS Pod需要先拉取指定的容器镜像，但因网络和容器镜像大小等因素，镜像拉取耗时往往成了ACS Pod启动的主要耗时。为加速实例的启动速度，ACS提供镜像缓存功能。通过预先将需要使用的镜像制作成镜像缓存，然后基于该镜像缓存来创建ACS Pod，避免或者减少镜像层的下载，从而提升实例的启动速度。

具体提升速度由 ACS Pod 中使用的容器镜像大小和镜像仓库网络因素等决定。

每个镜像缓存中可以包含一个镜像。镜像缓存状态制作中表示正处于制作镜像缓存阶段。稍等一段时间，当状态变成制作完成后即可支持使用镜像缓存。

具体镜像缓存制作时间与容器镜像大小与配置的网络带宽相关。如果由于网络不通、认证失败、仓库/Tag 不存在等原因，可能会导致超时制作失败。

计费说明

注意事项

• 目前 ACS 镜像缓存功能在白名单邀测阶段，可提交工单申请开通。

• 首次创建镜像缓存会为用户创建Service Linked Role，因此需要确保调用创建的子账号具有ram:CreateServiceLinkedRole权限。

• 制作完成后会显示镜像缓存大小，该数值为容器镜像解压缩后完整文件和容器镜像缓存额外索引文件的总大小。镜像缓存目前支持解压前不超过500GiB的镜像制作。

• 镜像缓存单地域默认配额为200，可提交工单申请提升。

• 目前镜像缓存支持的地域：华北2（北京）、华东2（上海）、华东1（杭州）、华北6（乌兰察布）。

• 目前镜像缓存支持的镜像类型：linux/amd64。

• 目前 GPU 场景镜像缓存支持的卡型：G59、G49E、L20（GN8IS）。

创建镜像缓存

使用镜像缓存

功能开启后，Pod将自动匹配使用最优的镜像缓存：

• 镜像匹配度：选择镜像名完全匹配的镜像缓存。

• 创建时间：优先选择创建时间最近且可用的镜像缓存。

1. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择工作负载 > 容器组，然后单击使用YAML创建资源。

2. 使用以下YAML创建Pod并添加注解开启镜像缓存匹配能力。

   请确保网络配置和密钥信息能够访问到所配置的镜像仓库，目前imagePullPolicy为Always。

   apiVersion: v1
   kind: Pod
   metadata:
     labels:
       name: hello-pod
     name: hello-pod
     annotations:
       image.alibabacloud.com/enable-image-cache: "true"
   spec:
     containers:
       - image: egs-registry.cn-hangzhou.cr.aliyuncs.com/egs/vllm:0.9.0.1-pytorch2.7-cu128-20250612 # 请替换为实际镜像缓存地址  
         command: ["/bin/sleep", "infinity"]
         imagePullPolicy: Always
         name: hello-pod
         ports:
           - containerPort: 8080
             protocol: TCP
         resources: {}
         securityContext:
           capabilities: {}
           privileged: false
         terminationMessagePath: /dev/termination-log
     dnsPolicy: ClusterFirst
     restartPolicy: Always

3. 创建成功后，单击Pod名称进入基本信息页面。开启镜像缓存匹配能力之后，创建的Pod会根据镜像名称尝试匹配镜像缓存，匹配成功的Pod会自动追加当前匹配的镜像缓存的注解。

   功能	参数	示例值	说明
   镜像缓存命中信息	image.alibabacloud.com/matched-image-caches	[{"imageCacheId":"imc-*****t15xuii6tz*****","size":30}]	命中的镜像缓存ID及大小（GiB）。