Tüm Ürünler
Search
Belge Merkezi

Elastic Container Instance:Image cache annotations

Son Güncelleme:Oct 06, 2026

ImageCache CRD ile bir görüntü önbelleği oluştururken ağ bağlantısı, görüntü kayıt defteri kimlik doğrulaması, önbellek optimizasyonu ve önbellek yaşam döngüsünü kontrol etmek için ek açıklamalar ekleyin. Bu konuda, her senaryo için YAML örnekleriyle birlikte desteklenen tüm ek açıklamalar listelenmektedir.

Ek açıklamalara genel bakış

Aşağıdaki tabloda, amaçlarına göre gruplandırılmış tüm desteklenen ek açıklamalar listelenmiştir.


Ek Açıklama


Örnek değer


Açıklama


Ağ Bağlantısı


k8s.aliyun.com/vswitch-ids


"vsw-bp1dktddjsg5nktv**,vsw-bp1xpiowfm5vo8o3c**"


Çok alanlı görüntü önbelleği oluşturma için vSwitch ID'leri. Birden fazla ID'yi virgülle ayırın. Varsayılan: eci-profile içinde yapılandırılan vSwitch.


k8s.aliyun.com/security-group-id


"sg-bp1dktddjsg5nktv****"


Güvenlik grubu ID'si. Varsayılan: eci-profile içinde yapılandırılan güvenlik grubu.


k8s.aliyun.com/resource-group-id


"rg-aek2z3elfs4****"


Kaynak grubu ID'si. Varsayılan: eci-profile içinde yapılandırılan kaynak grubu.


Görüntü kayıt defteri kimlik doğrulaması


k8s.aliyun.com/acr-instance-ids


"cri-j36zhodptmyq****"


Sırrsız görüntü çekme için Container Registry Kurumsal Sürüm örnek ID'leri. Farklı bir bölgedeki bir örnekten çekme yapmak için örnek ID'sinin başına bölge ID'sini ekleyin: "cn-beijing:cri-j36zhodptmyq****".


k8s.aliyun.com/acr-service-arns


acs:ram::1609982529******:role/role-assume


Elastic Container Instance (ECI) kaynaklarına sahip olan Alibaba Cloud hesabındaki RAM rollerinin Alibaba Cloud Resource Name (ARN) değerleri. Kaynak oluşturmak için bir RAM rolü kullanılırken gereklidir.


k8s.aliyun.com/acr-user-arns


acs:ram::1298452580******:role/role-acr


Container Registry örneğine sahip olan Alibaba Cloud hesabındaki RAM rollerinin ARN değerleri. Hesaplar arası görüntü çekme işlemi için gereklidir.


k8s.aliyun.com/plain-http-registry


"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80"


HTTP kullanan kendi yönettiğiniz görüntü deposunun adresi. Varsayılan olarak esnek konteyner örnekleri görüntüleri HTTPS üzerinden çeker. Örneğin belirtilen depo için HTTP kullanmasını sağlamak üzere bu ek açıklamayı ekleyin.


k8s.aliyun.com/insecure-registry


"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80"


Kendi imzalanan sertifika kullanan kendi yönettiğiniz görüntü deposunun adresi. Sertifika doğrulamasını atlamak ve çekme hatalarını önlemek için bu ek açıklamayı ekleyin.


Önbellek optimizasyonu


k8s.aliyun.com/imc-enable-reuse


"true"


Görüntü önbelleği katmanı yeniden kullanımını etkinleştirir. Bir görüntü önbelleği oluştururken sistem mevcut görüntü önbelleklerini denetler ve eşleşen görüntü katmanlarını yeniden kullanarak oluşturma süresini azaltır.


k8s.aliyun.com/imc-enable-flash


"true"


Anlık görüntü önbelleğini etkinleştirir. Sistem geçici bir yerel anlık görüntü oluşturarak görüntü önbelleğinin hemen kullanılabilir olmasını sağlar. Arka planda sistem standart bir anlık görüntü oluşturur; hazır olduğunda yerel anlık görüntü otomatik olarak kaldırılır.


Önbellek yaşam döngüsü


k8s.aliyun.com/imc-retention-days


"7"


Saklama süresi (gün cinsinden). Süresi dolan görüntü önbellekleri otomatik olarak silinir. Varsayılan: boş (süresiz).


k8s.aliyun.com/imc-size


"25"


Görüntü önbelleği boyutu (GiB cinsinden). Varsayılan: 20. Geçerli aralık: 20–32768.


EIP üzerinden internet erişimi


k8s.aliyun.com/eip-instance-id


"eip-bp1q5n8cq4p7f6dzu****"


Görüntü önbelleği oluşturma sırasında geçici esnek konteyner örneğiyle ilişkilendirilecek mevcut Elastic IP Address (EIP) ID'si. EIP, görüntü önbelleği oluşturulduktan sonra korunur.


k8s.aliyun.com/auto-create-eip


"true"


Otomatik olarak bir EIP oluşturur ve bunu geçici esnek konteyner örneğiyle ilişkilendirir. EIP, görüntü önbelleği oluşturulduktan sonra serbest bırakılır.


k8s.aliyun.com/eip-bandwidth


"5"


Otomatik oluşturulan EIP'nin bant genişliği sınırı (Mbit/s cinsinden).


k8s.aliyun.com/eip-internet-charge-type


PayByBandwidth


Otomatik oluşturulan EIP için faturalama yöntemi. Geçerli değerler: PayByBandwidth (bant genişliğine göre ödeme), PayByTraffic (trafiğe göre ödeme).


k8s.aliyun.com/eip-isp


BGP


Otomatik oluşturulan EIP için hat türü. Yalnızca kullandıkça öde EIP'ler için geçerlidir. Geçerli değerler: BGP (varsayılan, BGP (Multi-ISP) hattı), BGP_PRO (BGP (Multi-ISP) Pro hatları).


k8s.aliyun.com/eip-common-bandwidth-package-id


"cbwp-2zeukbj916scmj51m****"


Otomatik oluşturulan EIP ile ilişkilendirilecek EIP bant genişliği planının ID'si.

Çok alanlı görüntü önbelleği oluşturma

ECI, görüntüleri çekmek ve önbelleğe almak için geçici bir esnek konteyner örneği oluşturur. Bir alan kullanılamadığında bile önbellek oluşturma işleminin başarılı olmasını sağlamak için farklı alanlarda birden fazla vSwitch belirtin.

Not: Varsayılan olarak Kubernetes kümesi veya VNode içinde yapılandırılan vSwitch kullanılır. Küme veya VNode zaten birden fazla alanı kapsıyorsa vSwitch'leri açıkça belirtmeniz gerekmeyebilir.
apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/vswitch-ids: "vsw-bp1dktddjsg5nktv****,vsw-bp1xpiowfm5vo8o3c****"  # Multiple vSwitches for multi-zone support.
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize: 25
  retentionDays: 7

Güvenlik grubu ve kaynak grubu yapılandırma

Varsayılan olarak eci-profile içindeki güvenlik grubu ve kaynak grubu kullanılır. Belirli bir görüntü önbelleği için bunları geçersiz kılmak üzere aşağıdaki ek açıklamaları kullanın.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/security-group-id: "sg-bp1dktddjsg5nktv****"  # Override the default security group.
    k8s.aliyun.com/resource-group-id: "rg-aek2z3elfs4****"       # Override the default resource group.
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize: 25
  retentionDays: 7

Sırrsız Container Registry'den görüntü çekme

Sırrsız görüntü çekme, ECI'nin Kubernetes Sırları olmadan Container Registry'den görüntü çekmesine olanak tanır. Destek, Container Registry örneğinin aynı Alibaba Cloud hesabında olup olmadığına ve kullandığınız sürüme bağlıdır.


Aynı hesap


Container Registry sürümü


Sırrsız görüntü çekme


Evet


Kişisel Sürüm veya Kurumsal Sürüm (varsayılan etki alanı)


Varsayılan olarak etkindir. Sırrsız çekmeyi destekleyen örneklerin kapsamını sınırlamak için bir RAM rolü yapılandırın.


Evet


Kurumsal Sürüm (özel etki alanı)


Varsayılan olarak etkin değildir. k8s.aliyun.com/acr-instance-ids kullanarak Container Registry örneklerini açıkça belirtin.


Hayır


Kişisel Sürüm veya Kurumsal Sürüm


Varsayılan olarak etkin değildir. k8s.aliyun.com/acr-service-arns ve k8s.aliyun.com/acr-user-arns kullanarak bir RAM rolü yapılandırın.

Yapılandırma ayrıntıları için bkz. Sır kullanmadan Container Registry örneğinden görüntü çekme.

Kendi yönettiğiniz görüntü depolarını kullanma

Kendi yönettiğiniz bir görüntü deposu HTTP veya kendi imzalanan sertifika kullanıyorsa, görüntü çekme işlemleri varsayılan olarak ErrImagePull hatasıyla başarısız olur. Hatayı önlemek için uygun ek açıklamayı ekleyin.

HTTP depoları

Varsayılan olarak esnek konteyner örnekleri görüntüleri HTTPS üzerinden çeker. Kendi yönettiğiniz depo HTTP kullanıyorsa görüntü çekme işlemleri ErrImagePull hatasıyla başarısız olur. Belirtilen depo için HTTP'ye izin vermek üzere k8s.aliyun.com/plain-http-registry ek açıklamasını ekleyin.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/plain-http-registry: "192.168.XX.XX:5000"  # Allow HTTP pulls from this repository.
spec:
  images:
  - 192.168.XX.XX:5000/test/nginx:latest
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  imageCacheSize: 25
  retentionDays: 7

Kendi imzalanan sertifika kullanan depolar

Kendi yönettiğiniz depo kendi imzalanan sertifika kullanıyorsa görüntü çekme işlemleri ErrImagePull hatasıyla başarısız olur. Belirtilen depo için sertifika doğrulamasını atlamak üzere k8s.aliyun.com/insecure-registry ek açıklamasını ekleyin.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/insecure-registry: "harbor***.pre.com"  # Skip certificate verification for this repository.
spec:
  images:
  - harbor***.pre.com/test/nginx:latest
  imagePullSecrets:
  - default:secret1
  - default:secret2
  - kube-system:secret3
  imageCacheSize: 25
  retentionDays: 7
Birden fazla depodan çekme yapmak için adreslerini virgülle ayırın: harbor***.pre.com,192.168.XX.XX . Bir depo adresi bağlantı noktası içeriyorsa bağlantı noktasını ek açıklama değerine dahil edin: 192.168.XX.XX:5000 .

Görüntü önbelleği katmanı yeniden kullanımını etkinleştirme

Görüntü önbelleği oluşturma süresi görüntü boyutuna ve ağ koşullarına bağlıdır. Katman yeniden kullanımı etkinleştirildiğinde sistem yeni bir tane oluşturmadan önce mevcut görüntü önbelleklerini denetler ve eşleşen katmanları yeniden kullanır; bu da ortak temel katmanları paylaşan görüntüler için oluşturma süresini önemli ölçüde azaltır.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-reuse: "true"  # Reuse matching layers from existing image caches.
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize: 25
  retentionDays: 7

Anlık görüntü önbelleğini etkinleştirme

Anlık görüntü önbelleği etkinleştirildiğinde sistem öncelikle geçici esnek konteyner örneğinin diskleri için geçici bir yerel anlık görüntü oluşturur. Görüntü önbelleği, tam bir standart anlık görüntüyü beklemeden yerel anlık görüntü hazır olur olmaz kullanılabilir hale gelir.

Yerel anlık görüntü oluşturulduktan sonra sistem arka planda standart bir anlık görüntü oluşturur. Görüntü önbelleği bu süreç boyunca kullanılabilir durumda kalır. Standart anlık görüntü hazır olduğunda yerel anlık görüntü otomatik olarak kaldırılır ve görüntü önbelleği standart anlık görüntüden çalışmaya devam eder.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-enable-flash: "true"  # Enable instant image cache for faster availability.
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize: 25
  retentionDays: 7

Önbellek boyutu ve saklama süresi yapılandırma

Varsayılan olarak görüntü önbelleklerinin boyutu 20 GiB'dir ve süresi dolmaz. Boyutu ve saklama süresini ek açıklamalarla veya spec bölümündeki imageCacheSize ve retentionDays alanlarıyla ayarlayın.

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/imc-retention-days: "7"  # Delete the image cache after 7 days.
    k8s.aliyun.com/imc-size: "25"           # Set the image cache size to 25 GiB.
spec:
  images:
  - centos:latest
  - busybox:latest

EIP üzerinden internet erişimi yapılandırma

Görüntü önbelleği oluşturma sırasında geçici esnek konteyner örneğinin görüntüleri çekmek için internete erişmesi gerekir. VPC'nizde NAT ağ geçidi yoksa geçici örnekle bir Elastic IP Address (EIP) ilişkilendirin.

İki seçenek mevcuttur:


Seçenek


EIP yaşam döngüsü


Mevcut bir EIP kullanma


EIP, görüntü önbelleği oluşturulduktan sonra korunur.


EIP'yi otomatik oluşturma


EIP, görüntü önbelleği oluşturulduktan sonra geçici örneklerle birlikte serbest bırakılır.

Mevcut bir EIP kullanma

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

EIP'yi otomatik oluşturma

apiVersion: eci.alibabacloud.com/v1
kind: ImageCache
metadata:
  name: imagecache-sample
  annotations:
    k8s.aliyun.com/auto-create-eip: "true"                                        # Auto-create and associate an EIP.
    k8s.aliyun.com/eip-bandwidth: "10"                                             # Bandwidth limit in Mbit/s.
    k8s.aliyun.com/eip-internet-charge-type: PayByBandwidth                        # Billing method: PayByBandwidth or PayByTraffic.
    k8s.aliyun.com/eip-common-bandwidth-package-id: "cbwp-2zeukbj916scmj51m****"  # EIP bandwidth plan ID.
spec:
  images:
  - centos:latest
  - busybox:latest
  imageCacheSize: 25
  retentionDays: 7