Gerçek düğümler ile sanal düğümlerin bir arada bulunduğu karma kümelerde, kapsülleri (pods) Elastic Container Instance (ECI) üzerinde zamanlamak ve ECI'ye özel özellikleri etkinleştirmek için genellikle kapsül YAML dosyalarında değişiklik yapılması gerekir; bu durum platform işlemleri ile uygulama yapılandırması arasındaki sınırı belirsizleştirir. eci-profile bu yükü ortadan kaldırır. Küme yöneticisi olarak, zamanlama kurallarını ve açıklama (annotation) eklemelerini tek bir küme düzeyindeki ConfigMap içinde tanımlarsınız ve kapsüller, uygulama YAML dosyalarında herhangi bir değişiklik yapmanıza gerek kalmadan doğru yapılandırmayı otomatik olarak alır.
Nasıl Çalışır
Bir kapsül oluşturulduğunda, ack-virtual-node kube-system ad alanındaki eci-profile adlı ConfigMap'i okur ve data bölümündeki yapılandırmayı kapsüle uygular.
eci-profile üç temel yetenek sunar:
ECI Zamanlayıcı — Değiştirici webhook (mutating webhook) mekanizmasını kullanarak, kapsül etiketlerine veya ad alanı etiketlerine göre kapsülleri ECI'ye yönlendirir. Bu sayede, tek tek kapsül YAML dosyalarına zamanlama yönergeleri eklemenize gerek kalmaz.
ECI Efekti — Eşleşen kapsüllere otomatik olarak açıklamalar (annotations) ve etiketler ekleyerek Elastic Compute Service (ECS) örnek türlerini belirtme, görüntü önbelleklerini etkinleştirme ve Ağ Zaman Protokolü (NTP) hizmetini yapılandırma gibi gelişmiş ECI özelliklerinin kullanılmasını sağlar. Desteklenen tüm açıklamaların listesi için bkz. ECI Kapsül Açıklaması.
Anında Güncellemeler — eci-profile üzerindeki yapılandırma değişiklikleri (küme IP adresi, hibrit cloud, günlük toplama, vSwitch'ler) yeni oluşturulan kapsüller için hemen etkili olur. ack-virtual-node bileşeninin yeniden başlatılmasına gerek yoktur. Mevcut kapsüller değişiklikleri yalnızca ardışık güncelleme (rolling update) sonrasında alır.
Ön Koşullar
Başlamadan önce şunları yaptığınızdan emin olun:
Kümenizdeki ack-virtual-node eklentisinin en son sürümde olması gerekir. Güncellemek için bkz. Bileşenleri Yönetme.
Kümenizde değiştirici webhook'ların (mutating webhooks) etkinleştirilmiş olması gerekir (ECI Zamanlayıcı için gereklidir). ACK Serverless kümelerindeki kapsüller otomatik olarak ECI'ye zamanlanır; bu nedenle bu kümelerde ECI Zamanlayıcıya gerek yoktur.
Kullanım Notları
eci-profile'u güncelledikten sonra, yeni oluşturulan ECI kapsülleri güncellenmiş yapılandırmayı hemen kullanır. Mevcut kapsüller ise güncellenmiş yapılandırmayı yalnızca ardışık güncellemeden sonra kullanır.
Bir seçici için
namespaceSelectorveyaobjectSelectoryapılandırmazsanız ancakeffectyapılandırırsanız, efekt ayarları ECI'ye zamanlanan tüm kapsüllere uygulanır.Birden fazla seçici bir kapsülle eşleşirse, bunlar sırayla değerlendirilir. Daha önce eşleşen seçicilerden gelen açıklamalar ve etiketler, daha sonra eşleşenlerden gelenlere göre önceliklidir. Mevcut kapsül açıklamaları ve etiketleri her zaman
effecttarafından eklenenlerin üzerinde önceliğe sahiptir.
eci-profile'u Görüntüleme
Geçerli eci-profile ConfigMap'ini görüntülemek için aşağıdaki komutu çalıştırın:
kubectl get cm -n kube-system eci-profile -o yaml
ConfigMap'in data bölümü iki tür yapılandırma içerir:
| Parametre | Açıklama |
|---|---|
selectors |
ECI Zamanlayıcı ve ECI Efekti kurallarını tanımlar. Bkz. Seçicileri Yapılandırma. |
Diğer parametreler (vpcId, vSwitchIds vb.) |
Kapsül düzeyinde bir geçersiz kılma olmadığında uygulanan küme düzeyi parametrelerdir. Anında güncellemeleri desteklerler. Bkz. Küme Düzeyi Parametreleri Güncelleme. |
Varsayılan bir eci-profile şu şekilde görünür:
apiVersion: v1
data:
enableClusterIp: "true"
enableHybridMode: "false"
enableLinuxArm64Node: "false"
enableLogController: "false"
enablePVCController: "false"
enablePrivateZone: "false"
enableReuseSSLKey: "false"
featureGates: "WaitForFirstConsumer=false"
securityGroupId: sg-2zeeyaaxlkq9sppl****
selectors: ""
slsMachineGroup: ""
vSwitchIds: vsw-2ze23nqzig8inprou****,vsw-2ze94pjtfuj9vaymf****
vpcId: vpc-2zeghwzptn5zii0w7****
kind: ConfigMap
metadata:
creationTimestamp: "2023-01-11T08:28:14Z"
name: eci-profile
namespace: kube-system
resourceVersion: "356"
uid: b345fa8c-919e-41fc-a981-57864b1a****
eci-profile'u Düzenleme
eci-profile'u düzenlemek için aşağıdaki yöntemlerden birini kullanın.
kubectl
kubectl edit configmap eci-profile -n kube-system
ACK konsolu
Container Service ACK konsoluna giriş yapın.
Clusters sayfasında hedef kümenin adına tıklayın.
Sol gezinme bölmesinde Configurations > ConfigMaps seçeneğini belirleyin.
Namespace açılır listesinden kube-system seçeneğini seçin.
eci-profile öğesini bulun ve Actions sütununda Edit YAML seçeneğine tıklayın.
Seçicileri Yapılandırma
Seçiciler, hangi kapsüllerin ECI'ye yönlendirileceğini (ECI Zamanlayıcı) ve bu kapsüllere hangi açıklamaların veya etiketlerin ekleneceğini (ECI Efekti) tanımlar. Bir kapsül oluşturulduğunda sistem her seçiciyi sırayla değerlendirir ve eşleşen kuralları uygular.
Her seçici aşağıdaki alanları destekler:
name(gerekli) — Seçici için benzersiz bir ad.namespaceSelector(isteğe bağlı) — Kapsülleri ad alanı etiketlerine göre eşleştirir.matchLabelsaltında etiketleri belirtin. Birden fazla etiket AND mantığıyla değerlendirilir.objectSelector(isteğe bağlı) — Kapsülleri kapsül etiketlerine göre eşleştirir.matchLabelsaltında etiketleri belirtin. Birden fazla etiket AND mantığıyla değerlendirilir.effect(isteğe bağlı) — Eşleşen kapsüllere eklenecek açıklamalar ve etiketler. Eklenen değerler, mevcut kapsül açıklamalarını veya etiketlerini üzerine yazmaz.
Hem namespaceSelector hem de objectSelector yapılandırıldığında, bir kapsülün seçiciyle eşleşmesi için her ikisini de karşılaması gerekir. Hiçbiri yapılandırılmamış ancak effect yapılandırılmışsa, efekt ECI'ye zamanlanan tüm kapsüllere uygulanır.
Seçici Şablonu
data:
selectors: |
[
{
"name": "selector-demo1", # Required. Unique selector name.
"namespaceSelector": { # Optional. Matches by namespace labels.
"matchLabels": { # AND logic among multiple labels.
"eci": "true"
}
},
"objectSelector": { # Optional. Matches by pod labels.
"matchLabels": { # AND logic among multiple labels.
"eci": "true"
}
},
"effect": { # Optional. Annotations and labels to inject.
"annotations": {
"k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"
},
"labels": {
"created-by-eci": "true"
}
}
},
{
"name": "selector-demo2",
"objectSelector": {
"matchLabels": {
"eci": "test"
}
}
}
]
Yukarıdaki örnekte, selector-demo1 hem eci: true kapsül etiketine sahip olan hem de eci: true etiketine sahip bir ad alanında bulunan kapsüllerle eşleşir. Eşleşen kapsüller ECI'ye zamanlanır ve k8s.aliyun.com/eci-use-specs: ecs.c6.xlarge açıklaması ile created-by-eci: true etiketini alır.
Yapılandırmayı uygulamadan önce satır içi yorumları ( # ) kaldırın. JSON yorumları desteklemez.
Seçicilerin Etkili Olduğunu Doğrulama
Seçicileri güncelledikten sonra, kayıtlı olduklarını onaylamak için aşağıdaki komutu çalıştırın:
kubectl get mutatingwebhookconfigurations -o yaml vk-webhook
Çıktı yapılandırdığınız seçicileri içeriyorsa yapılandırma etkindir. İçermiyorsa, seçici JSON formatınızın doğru olup olmadığını kontrol edin.
Yapılandırma Örnekleri
Örnek 1: Belirli kapsülleri ECI'ye yönlendirme
Aşağıdaki seçici, kapsülde created-by-eci: true etiketi varsa ve ad alanında type: eci etiketi varsa kapsülü ECI'ye yönlendirir.
data:
selectors: |
[
{
"name": "eci-selector",
"namespaceSelector": {
"matchLabels": {
"type": "eci"
}
},
"objectSelector": {
"matchLabels": {
"created-by-eci": "true"
}
}
}
]
Örnek 2: Kapsülleri GPU hızlandırmalı örnek türüyle ECI'ye yönlendirme
Aşağıdaki seçici, ad alanında gpu: true etiketi bulunan kapsülleri ecs.gn6v-c8g1.2xlarge GPU hızlandırmalı örnek türünü kullanarak ECI'ye yönlendirir ve eşleşen kapsüllere gpu: test etiketini ekler.
data:
selectors: |
[
{
"name": "gpu-namespace-selector",
"namespaceSelector": {
"matchLabels": {
"gpu": "true"
}
},
"effect": {
"annotations": {
"k8s.aliyun.com/eci-use-specs": "ecs.gn6v-c8g1.2xlarge"
},
"labels": {
"gpu": "test"
}
}
}
]
Örnek 3: Kapsülleri otomatik görüntü önbelleği eşleştirme ile ECI'ye yönlendirme
Aşağıdaki seçici, imc: auto etiketine sahip kapsülleri ECI'ye yönlendirir ve otomatik görüntü önbelleği eşleştirmeyi etkinleştirir.
data:
selectors: |
[
{
"name": "autoimc-object-selector",
"objectSelector": {
"matchLabels": {
"imc": "auto"
}
},
"effect": {
"annotations": {
"k8s.aliyun.com/eci-auto-imc": "true"
}
}
}
]
Küme Düzeyi Parametreleri Güncelleme
data bölümündeki aşağıdaki parametreler küme düzeyi varsayılanlardır. Kapsül düzeyinde bir geçersiz kılma olmadan bir kapsül oluşturulduğunda eci-profile değerleri kullanılır. Tüm parametreler anında güncellemeleri destekler; değişiklikler ack-virtual-node yeniden başlatılmadan hemen etkili olur.
Bu parametreler yalnızca kapsül düzeyinde bir yapılandırma bunları geçersiz kılmadığında uygulanır.
| Parametre | Varsayılan | Açıklama |
|---|---|---|
enableClusterIp |
"true" |
Küme IP adresinin desteklenip desteklenmeyeceği. |
enableHybridMode |
"false" |
Hibrit cloud modunun etkinleştirilip etkinleştirilmeyeceği. |
enableLinuxArm64Node |
"false" |
ARM tabanlı düğümlerin etkinleştirilip etkinleştirilmeyeceği. Bkz. Kapsülleri ARM Tabanlı Sanal Düğüme Zamanlama. |
enableLogController |
"false" |
Kapsül günlüklerini toplamak için Simple Log Service Özel Kaynak Tanımı (CRD) kullanılıp kullanılmayacağı. "true" olarak ayarlanırsa slsMachineGroup da yapılandırılmalıdır. |
enablePVCController |
"false" |
Çevrimiçi disk genişletmenin etkinleştirilip etkinleştirilmeyeceği. "true" olarak ayarlanırsa sistem disklere bağlı Kalıcı Birim Taleplerini (PVC'ler) anında genişletebilir. |
enablePrivateZone |
"false" |
Alan adı çözümlemesi için PrivateZone kullanılıp kullanılmayacağı. |
enableReuseSSLKey |
"false" |
SSL anahtarlarının kapsüller arasında yeniden kullanılıp kullanılmayacağı. Varsayılan olarak ack-virtual-node her kapsüle benzersiz bir SSL sertifikası verir. Bu değeri "true" olarak ayarlamak tüm kapsüllerin aynı sertifikayı paylaşmasını sağlar; bu durum güvenliği azaltmak pahasına kapsül oluşturma verimini artırır. |
featureGates |
"WaitForFirstConsumer=false" |
Canary özellik kapısı. Yalnızca WaitForFirstConsumer yapılandırılabilir. Aşağıdaki nota bakın. |
securityGroupId |
— | ECI kapsülleri için güvenlik grubu. Örnek: sg-2zeeyaaxlkq9sppl****. |
slsMachineGroup |
— | ECI kapsülleri için makine grubu. enableLogController "true" olduğunda gereklidir. Örnek: test-mg. |
vSwitchIds |
— | ECI kapsülleri için vSwitch'lerin kimlikleri. Birden fazla kimliği virgülle ayırın. Örnek: vsw-2ze23nqzig8inprou**,vsw-2ze94pjtfuj9vaymf**. |
vpcId |
— | ECI kapsüllerinin dağıtıldığı Virtual Private Cloud (VPC) kimliği. Örnek: vpc-2zeghwzptn5zii0w7****. |
featureGates: WaitForFirstConsumer Hakkında
WaitForFirstConsumer "true" olarak ayarlandığında:
Bu ayarı etkinleştirmeden önce csi-provisioner eklentisinin en son sürümde olması gerekir.
Kalıcı Birimler (PV'ler) ve arka uç depolama yalnızca kapsül zamanlandıktan sonra oluşturulur. StorageClass'ta belirtilen alan ve bölge artık kullanılmaz; bunun yerine, zamanlanan kapsülün düğümünün alanı ve bölgesi depolama kaynaklarını oluşturmak için kullanılır. Bu sayede hesaplama kaynaklarına öncelikli olarak zamanlama yapılır.
Daha fazla bilgi için bkz. Birim Bağlama Modu.
Tam bir data bölümü örneği:
data:
enableClusterIp: "true"
enableHybridMode: "false"
enableLinuxArm64Node: "false"
enableLogController: "false"
enablePVCController: "false"
enablePrivateZone: "false"
enableReuseSSLKey: "false"
securityGroupId: sg-2zeeyaaxlkq9sppl****
selectors: ""
slsMachineGroup: ""
vSwitchIds: vsw-2ze23nqzig8inprou****,vsw-2ze94pjtfuj9vaymf****
vpcId: vpc-2zeghwzptn5zii0w7****