Tüm Ürünler
Search
Belge Merkezi

Elastic Container Instance:eci-profile'ı otomatik olarak görüntü önbelleği kullanacak şekilde yapılandırın

Son Güncelleme:Oct 06, 2026

eci-profile içindeki ECI Effect özelliği, eşleşen pod'lara ImageCache ile ilgili ek açıklamaları otomatik olarak enjekte eden seçiciler tanımlamanıza olanak tanır. Bir pod bir seçicinin etiket koşullarıyla eşleştiğinde sistem belirtilen ek açıklamaları manuel müdahale olmadan ekler; bu sayede tek tek pod belirtimlerine dokunmadan pod oluşturma süreci hızlanır.

Not: eci-profile hakkında arka plan bilgisi için bkz. Bir eci-profile yapılandırma .

Ön koşullar

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

  • ECI etkinleştirilmiş bir Kubernetes kümesine erişim

  • kube-system ad alanındaki eci-profile ConfigMap dosyasını düzenleme izni

  • Kümenizle iletişim kuracak şekilde yapılandırılmış kubectl

Nasıl çalışır

eci-profile, pod oluşturma isteklerini yakalamak için mutasyon webhook'u (vk-webhook) kullanır. Bir pod oluşturulduğunda webhook pod'un ve ad alanının etiketlerini eci-profile içinde tanımlanan seçicilere göre kontrol eder. Eşleşme bulunursa webhook ilgili ek açıklamaları pod'a enjekte ederek görüntü önbelleği hızlandırmayı otomatik olarak etkinleştirir.

ImageCache ek açıklamaları

Aşağıdaki ek açıklamalar pod oluşturma sırasında görüntü önbelleklerinin nasıl kullanılacağını belirler.

Ek Açıklama Örnek değer Açıklama
k8s.aliyun.com/eci-auto-imc "true" Otomatik görüntü önbelleği eşleştirmeyi etkinleştirir. "true" olarak ayarlandığında sistem en uygun görüntü önbelleğini şu kriterlere göre seçer: görüntü eşleşme derecesi, görüntü boyutu ve oluşturma zamanı. Tam eşleşme yoksa sistem pod oluşturulduğunda yeni bir görüntü önbelleği oluşturur. Varsayılan: "true".
k8s.aliyun.com/imc-perfect-match "true" Pod'daki tüm konteyner görüntülerinin görüntü önbelleğiyle tam olarak eşleşmesini gerektirir. Varsayılan: "false".
k8s.aliyun.com/imc-match-count-request "2" Pod'daki konteyner görüntülerinden kaç tanesinin görüntü önbelleğiyle tam olarak eşleşmesi gerektiğini belirtir.
k8s.aliyun.com/eci-imc-id imc-2zebxkiifuyzzlhl**** Pod'u belirli bir görüntü önbelleğine kimliğiyle sabitler.

Seçici alanları

eci-profile'ın selectors dizisindeki her seçicinin aşağıdaki alanları vardır:

Alan Zorunlu Açıklama
name Evet Seçici için benzersiz bir ad.
namespaceSelector Hayır Ad alanı etiketlerine göre pod'ları eşleştirir. Belirtilmezse tüm ad alanları uygundur.
objectSelector Hayır Pod etiketlerine göre pod'ları eşleştirir. Belirtilmezse eşleşen ad alanındaki tüm pod'lar uygundur.
effect.annotations Evet Eşleşen pod'lara enjekte edilecek ek açıklamalar.

namespaceSelector.matchLabels veya objectSelector.matchLabels içinde birden fazla etiket belirtildiğinde tüm etiketlerin eşleşmesi gerekir (VE mantığı).

Seçicileri yapılandırın

  1. Düzenlemek için eci-profile ConfigMap dosyasını açın:

    kubectl -n kube-system edit cm eci-profile
  2. Seçicilerinizi dizi biçiminde selectors alanına ekleyin:

    selectors: |
     [
      {
          "name": "demo",
          "namespaceSelector": {
              "matchLabels": {
                  "app": "nginx"
              }
          },
          "objectSelector": {
              "matchLabels": {
                  "type": "test"
              }
          },
          "effect": {
              "annotations": {
                  "k8s.aliyun.com/eci-auto-imc": "true"
              }
          }
      }
     ]
  3. Değişiklikleri kaydedin ve düzenleyiciden çıkın. Kubernetes değişiklikleri otomatik olarak uygular.

Yapılandırmayı doğrulayın

Seçicilerin aktif olduğunu onaylamak için aşağıdaki komutu çalıştırın:

kubectl get mutatingwebhookconfigurations -o yaml vk-webhook

Dönen YAML yapılandırılmış seçicileri içeriyorsa seçiciler etkindir. Seçiciler yoksa ConfigMap'in selectors alanında JSON biçimlendirme hataları olup olmadığını kontrol edin.

Örnek

Aşağıdaki örnek farklı eşleştirme stratejilerine sahip iki seçici tanımlar.

eci-profile ConfigMap dosyasını düzenleyin:

kubectl -n kube-system edit cm eci-profile

Aşağıdaki içeriği selectors alanına ekleyin:

[
  ...
  {
    "name": "image-cache-selector-1",
    "objectSelector": {
      "matchLabels": {
        "image-cache": "true"
      }
    },
    "effect": {
      "annotations": {
        "k8s.aliyun.com/eci-imc-id": "imc-uf6ic***************"
      }
    }
  },
  {
    "name": "image-cache-selector-2",
    "namespaceSelector": {
      "matchLabels": {
        "image-cache": "true"
      }
    },
    "effect": {
      "annotations": {
        "k8s.aliyun.com/eci-auto-imc": "true"
      }
    }
  }
]

Her seçicinin çalışma şekli:

  • image-cache-selector-1: image-cache: true etiketine sahip herhangi bir pod k8s.aliyun.com/eci-imc-id: imc-uf6ic*************** ek açıklamasını otomatik olarak alır ve belirtilen görüntü önbelleğine sabitlenir.

  • image-cache-selector-2: image-cache: true etiketine sahip bir ad alanında oluşturulan herhangi bir pod k8s.aliyun.com/eci-auto-imc: "true" ek açıklamasını otomatik olarak alır; bu da o ad alanındaki tüm pod'lar için otomatik görüntü önbelleği eşleştirmeyi etkinleştirir.

Sırada ne var