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-systemad alanındakieci-profileConfigMap dosyasını düzenleme izniKü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
-
Düzenlemek için eci-profile ConfigMap dosyasını açın:
kubectl -n kube-system edit cm eci-profile -
Seçicilerinizi dizi biçiminde
selectorsalanına ekleyin:selectors: | [ { "name": "demo", "namespaceSelector": { "matchLabels": { "app": "nginx" } }, "objectSelector": { "matchLabels": { "type": "test" } }, "effect": { "annotations": { "k8s.aliyun.com/eci-auto-imc": "true" } } } ] 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: trueetiketine sahip herhangi bir podk8s.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: trueetiketine sahip bir ad alanında oluşturulan herhangi bir podk8s.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.