弹性容器实例：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
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  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
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  imageCacheSize:
   25
  retentionDays:
   7

免密拉取ACR镜像

容器镜像服务ACR是面向容器镜像、Helm Chart等符合OCI标准的云原生制品安全托管及高效分发平台，能够与容器服务ACK无缝集成，支持大规模和大镜像分发加速、多代码源构建加速等全链路加速能力。更多关于ACR的信息，请参见容器镜像服务ACR。

如果您使用ACR企业版实例来管理您的镜像，创建ImageCache时，您可以指定ACR企业版实例，从对应的ACR实例中免密拉取镜像。

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/acr-instance-ids: "cri-j36zhodptmyq****" #指定ACR企业版实例
spec:
  images:
  - centos:latest
  - busybox:latest
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  imageCacheSize:
   25
  retentionDays:
   7

使用自建镜像仓库

使用自建镜像仓库中的镜像创建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
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  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
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  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
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3

配置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
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    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的带宽
      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
    imagePullSecrets:
    - default:secret1
    - default:secret2
    - kube-system:secret3
    imageCacheSize:
     25
    retentionDays:
     7