弹性容器实例：ImageCache Annotation

ImageCache Annotation列表

ImageCache目前支持的Annotation如下表所示。

多可用区创建资源

创建ImageCache的过程中，系统将临时创建一个ECI实例用于中转创建ImageCache。为避免ECI实例资源库存的影响，保证ImageCache可以创建成功，您可以指定多个交换机来实现多可用区功能。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/vswitch-ids: "vsw-bp1dktddjsg5nktv****,vsw-bp1xpiowfm5vo8o3c****"  # 指定多个交换机
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

指定CPU架构

拉取Arm架构的镜像来创建ImageCache时，需要指定CPU架构。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-cpu-arch: "arm64" # 指定CPU架构为Arm
spec:
  images:
  - arm64v8/centos:7.9.2009   # 使用基于Arm架构的容器镜像
  imageCacheSize:
   25
  retentionDays:
   7

指定操作系统

拉取Windows镜像来创建ImageCache时，需要指定操作系统。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-os-type: "windows" # 指定操作系统为Windows
spec:
  images:
  - mcr.microsoft.com/windows/nanoserver:ltsc2022   # 使用Windows容器镜像
  imageCacheSize:
   25
  retentionDays:
   7

设置安全组和资源组

创建ImageCache时，默认采用eci-profile中配置的安全组和资源组。如果您有特殊需求，可以指定安全组和资源组。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/security-group-id: "sg-bp1dktddjsg5nktv****" # 指定安全组
    k8s.aliyun.com/resource-group-id: "rg-aek2z3elfs4****"      # 指定资源组
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

免密拉取ACR镜像

对于ACR镜像，根据ACR实例是否与待创建的ImageCache属于同一阿里云账号，以及ACR实例的类型，免密拉取镜像的支持情况如下：

具体配置，请参见免密拉取ACR镜像。

使用自建镜像仓库

使用自建镜像仓库中的镜像创建ImageCache时，如果镜像仓库采用HTTP协议，或者使用自签发证书，需配置相关Annotation避免镜像拉取失败。

• 自建镜像仓库采用HTTP协议

  由于ECI默认使用HTTPS协议拉取镜像，则创建ImageCache，需要配置k8s.aliyun.com/plain-http-registry，使得ECI使用HTTP协议与镜像仓库进行交互。

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/plain-http-registry: "192.168.XX.XX:5000"  # 指定自建镜像仓库地址，使用HTTP协议拉取镜像
  spec:
    images:
    - 192.168.XX.XX:5000/test/nginx:latest
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    imageCacheSize:
     25
    retentionDays:
     7

• 自建镜像仓库使用自签发证书

  使用自签发证书的情况下，拉取镜像时无法通过证书认证，需要配置k8s.aliyun.com/insecure-registry，以跳过证书认证。

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/insecure-registry: "harbor***.pre.com"  # 指定自建镜像仓库地址，拉取镜像时跳过正式认证
  spec:
    images:
    - harbor***.pre.com/test/nginx:latest
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    imageCacheSize:
     25
    retentionDays:
     7

开启镜像缓存复用

ImageCache的创建时长由镜像大小，网络等多种因素决定。创建ImageCache时，支持开启镜像缓存复用功能来加快ImageCache的创建速度。

开启镜像缓存复用后，在创建ImageCache的过程中，系统将自动匹配已有ImageCache，如果新的ImageCache与已有ImageCache存在重复的镜像层，新的ImageCache将复用已有ImageCache的镜像层，从而加速ImageCache的创建。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-reuse: "true"   # 开启镜像缓存复用
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

开启极速镜像缓存

ImageCache的创建时长由镜像大小、网络等多种因素决定。创建ImageCache时，支持开启极速镜像缓存功能来缩短创建时长。

开启极速镜像缓存后，在创建ImageCache的过程中，系统将临时创建一份本地快照。本地快照基于快照极速可用功能，可以快速创建，创建完成后即可使用ImageCache。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-flash: "true"   # 开启极速镜像缓存
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize:
   25
  retentionDays:
   7

设置镜像缓存的大小和保留时长

默认情况下，手动创建的ImageCache的大小为20 GiB，且创建后会一直保留。如果您想要自定义设置ImageCache的大小和保留时长，除了设置spec中的imageCacheSize和retentionDays参数外，还支持通过Annotation设置。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-retention-days: "7"   # 设置镜像缓存保留时长
    k8s.aliyun.com/imc-size: "25"            # 设置镜像缓存大小
spec:
  images:
  - centos:latest
  - busybox:latest

配置EIP拉取公网镜像

弹性公网IP（EIP）是可以独立购买和持有的公网IP地址资源，当EIP与云资源绑定时，云资源可以通过EIP与公网通信。更多关于EIP的信息，请参见弹性公网IP。

创建ImageCache时，如果您需要从公网拉取镜像，则需要确保当前网络能够连接公网。连接公网包括配置NAT网关和配置EIP两种方式。如果您的VPC没有绑定NAT网关，您可以配置EIP来拉取公网镜像。配置EIP包括以下两种方式：

• 绑定已有EIP

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/eip-instance-id: "eip-bp1q5n8cq4p7f6dzu****"   # 绑定已有的EIP
  spec:
    images:
    - centos:latest
    - busybox:latest
    imageCacheSize:
     25
    retentionDays:
     7

• 自动创建并绑定EIP

  apiVersion: eci.alibabacloud.com/v1
  kind: ImageCache
  metadata:
    name: imagecache-sample
    annotations:
      k8s.aliyun.com/auto-create-eip: "true"                                       # 自动创建并绑定EIP
      k8s.aliyun.com/eip-bandwidth: "10"                                           # 设置EIP的带宽，单位为Mbps
      k8s.aliyun.com/eip-internet-charge-type: PayByBandwidth                      # 设置EIP的计量方式
      k8s.aliyun.com/eip-common-bandwidth-package-id: "cbwp-2zeukbj916scmj51m****" # 使用共享带宽包
  spec:
    images:
    - centos:latest
    - busybox:latest
    imageCacheSize:
     25
    retentionDays:
     7