Tüm Ürünler
Search
Belge Merkezi

Elastic Container Instance:Configure an eci-profile

Son Güncelleme:Oct 06, 2026

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 namespaceSelector veya objectSelector yapılandırmazsanız ancak effect yapı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 effect tarafı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

  1. Container Service ACK konsoluna giriş yapın.

  2. Clusters sayfasında hedef kümenin adına tıklayın.

  3. Sol gezinme bölmesinde Configurations > ConfigMaps seçeneğini belirleyin.

  4. Namespace açılır listesinden kube-system seçeneğini seçin.

  5. 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. matchLabels altı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. matchLabels altı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.

Önemli

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****