Elastic Container Instance：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拉取公網鏡像

Elastic IP Address（EIP）是可以獨立購買和持有的公網IP地址資源，當EIP與雲資源綁定時，雲資源可以通過EIP與公網通訊。更多關於EIP的資訊，請參見Elastic IP Address。

建立ImageCache時，如果您需要從公網拉取鏡像，則需要確保當前網路能夠串連公網。串連公網包括配置NAT Gateway和配置EIP兩種方式。如果您的VPC沒有綁定NAT Gateway，您可以配置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