Tüm Ürünler
Search
Belge Merkezi

Elastic Container Instance:ImageCache Yönetimi

Son Güncelleme:Oct 06, 2026

Büyük konteyner görüntüleri çalıştırdığınızda veya pod'ları sık sık ölçeklendirdiğinizde, uzak bir kayıt defterinden görüntü çekmek pod başlatma süresine dakikalar ekleyebilir. ImageCache, Elastic Container Instance (ECI) tarafından sağlanan ve konteyner görüntülerini anlık görüntü olarak önceden önbelleğe alan bir Kubernetes CustomResourceDefinition (CRD) kaynağıdır. ECI bir pod oluştururken görüntüleri doğrudan önbellekten yükler; bu da büyük görüntüler veya sık ölçeklendirilen iş yükleri için başlatma süresini önemli ölçüde azaltır.

Bu konu, bir ImageCache öğesinin nasıl oluşturulacağını, sorgulanacağını ve silineceğini açıklar.

Bir ImageCache anlık görüntü olarak depolanır ve var olduğu sürece anlık görüntü maliyetlerine neden olur. Artık kullanılmayan ImageCache'leri silin.

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • ack-virtual-node bileşeni yüklü bir Kubernetes kümesi

  • Kümeye kubectl erişimi

Kümenizin ImageCache'leri Destekleyip Desteklemediğini Kontrol Edin

ImageCache CRD'sinin yüklü olduğunu doğrulamak için aşağıdaki komutu çalıştırın:

kubectl get crd/imagecaches.eci.alibabacloud.com

CRD bulunamazsa, çıktı şuna benzer:

Error from server (NotFound): customresourcedefinitions.apiextensions.k8s.io "imagecaches.eci.alibabacloud.com" not found

ack-virtual-node bileşenini, ImageCache'leri destekleyen bir sürüme güncelleyin. Yeni özelliklerden yararlanmak için ack-virtual-node bileşenini en son sürüme güncellemenizi öneririz. Sürüm bilgileri ve güncelleme talimatları için bkz. ack-virtual-node ve Sistem bileşenlerini yönetin.

CRD yüklüyse, çıktı şuna benzer:

NAME                               CREATED AT
imagecaches.eci.alibabacloud.com   2024-01-23T05:54:44Z

Yüklü CRD en son sürüm değilse, güncellenmiş CRD manifestosunu uygulayın:

kubectl apply -f imagecache-crd-sample.yaml

<details> <summary>imagecache-crd-sample.yaml dosyasını görüntüle</summary>

apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  name: imagecaches.eci.alibabacloud.com
spec:
  group: eci.alibabacloud.com
  version: v1
  names:
    kind: ImageCache
    plural: imagecaches
    shortNames:
    - ic
    categories:
    - all
  scope: Cluster
  subresources:
    status: {}
  validation:
    openAPIV3Schema:
      required:
      - spec
      properties:
        spec:
          type: object
          required:
          - images
          properties:
            imagePullSecrets:
              type: array
              items:
                type: string
            images:
              minItems: 1
              type: array
              items:
                type: string
            imageCacheSize:
              type: integer
            retentionDays:
              type: integer
  additionalPrinterColumns:
  - name: Age
    type: date
    JSONPath: .metadata.creationTimestamp
  - name: CacheId
    type: string
    JSONPath: .status.imageCacheId
  - name: Phase
    type: string
    JSONPath: .status.phase
  - name: Progress
    type: string
    JSONPath: .status.progress

</details>

ImageCache Oluşturma

YAML Manifestosunu Yapılandırma

Aşağıdaki yapıya sahip bir YAML dosyası (örneğin, imagecache-test.yaml) oluşturun. Her alan, hızlı referans için satır içi olarak açıklanmıştır.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample-test
  annotations:
    k8s.aliyun.com/imc-enable-reuse: "true"  # Enables ImageCache reuse across pods
spec:
  images:                                      # [Required] Images to cache
  - registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
  - registry.cn-shanghai.aliyuncs.com/eci_open/busybox:1.30
  imagePullSecrets:                            # [Optional] Secrets for private image repositories
  - default:secret1                            # Format: namespace:secretName
  - default:secret2
  - kube-system:secret3
  imageCacheSize: 25                           # [Optional] Cache size in GiB. Default: 20. Range: 20-32768.
                                               # Must be >= 2x the image size.
  retentionDays: 7                             # [Optional] Days before the cache is deleted. Default: never expires.

Parametre referansı:

Parametre Tür Gerekli Açıklama
spec.images String[] Evet Önbelleğe dahil edilecek konteyner görüntüleri
spec.imagePullSecrets String[] Hayır adalanı:gizliAd formatında, özel görüntü depoları için gizli diziler. Genel görüntüler için atlayın.
spec.imageCacheSize int Hayır GiB cinsinden önbellek boyutu. Varsayılan: 20. Geçerli aralık: 20–32768. Görüntü boyutunun en az iki katına ayarlayın.
spec.retentionDays int Hayır Otomatik silme işleminden önce önbelleğin saklanacağı gün sayısı. Varsayılan olarak boş bırakılır (süresi dolmaz).
Ek ImageCache özelliklerini etkinleştirmek için açıklamaları (annotations) kullanın. Örneğin, k8s.aliyun.com/imc-enable-reuse: "true" açıklaması, birden fazla pod'un aynı ImageCache'i paylaşmasına olanak tanır. Desteklenen tüm açıklamaların listesi için bkz. ImageCache açıklamaları . Tam API referansı için bkz. Kubernetes ImageCache API'si .

Manifestoyu Uygulama

kubectl create -f imagecache-test.yaml

ImageCache'in Hazır Olduğunu Doğrulama

kubectl get imagecache imagecache-sample-test

PHASE değeri Ready gösterdiğinde ve PROGRESS değeri 100% ulaştığında ImageCache hazırdır:

NAME                     AGE     CACHEID                    PHASE   PROGRESS
imagecache-sample-test   5m30s   imc-2ze2kbf9l1onf03z****   Ready   100%

ImageCache'leri Sorgulama

Kümedeki tüm ImageCache'leri listeleyin:

kubectl get imagecache

Belirli bir ImageCache'in tam yapılandırmasını ve durumunu alın:

kubectl get imagecache <imagecache-name> -o yaml

ImageCache Silme

kubectl delete imagecache <imagecache-name>
Bir ImageCache bir anlık görüntüdür. Devam eden anlık görüntü maliyetlerinden kaçınmak için artık ihtiyaç duyulmayan ImageCache'leri silin.

Sonraki Adımlar