Container Service for Kubernetes:Konfigurasikan eci-profile

Cara kerja

Saat sebuah Pod dibuat, ack-virtual-node membaca ConfigMap bernama eci-profile di namespace kube-system dan menerapkan konfigurasi pada bagian data-nya ke Pod tersebut.

eci-profile menyediakan tiga kemampuan:

• ECI Scheduler — Mengarahkan Pod ke ECI berdasarkan label Pod atau label namespace melalui mekanisme mutating webhook, sehingga menghilangkan kebutuhan untuk menambahkan direktif penjadwalan ke setiap file YAML Pod.

• ECI Effect — Secara otomatis menyuntikkan anotasi dan label ke Pod yang sesuai untuk mengaktifkan fitur lanjutan ECI, seperti menentukan tipe instans Elastic Compute Service (ECS), mengaktifkan cache gambar, dan mengonfigurasi layanan Network Time Protocol (NTP). Untuk daftar lengkap anotasi yang didukung, lihat ECI Pod Annotation.

• Pembaruan panas (Hot updates) — Perubahan konfigurasi pada eci-profile (seperti alamat IP kluster, cloud hibrida, pengumpulan log, dan vSwitch) langsung berlaku untuk Pod yang baru dibuat tanpa perlu restart ack-virtual-node. Pod yang sudah ada hanya menerapkan perubahan setelah rolling update.

Prasyarat

Sebelum memulai, pastikan bahwa:

• Add-on ack-virtual-node di kluster Anda menggunakan versi terbaru. Untuk memperbaruinya, lihat Kelola komponen.

• Mutating webhook diaktifkan di kluster Anda (diperlukan untuk ECI Scheduler). Pada kluster ACK Serverless, Pod dijadwalkan ke ECI secara otomatis sehingga ECI Scheduler tidak diperlukan.

Catatan penggunaan

• Setelah memperbarui eci-profile, Pod ECI yang baru dibuat langsung menggunakan konfigurasi terbaru. Pod yang sudah ada hanya menggunakan konfigurasi terbaru setelah rolling update.

• Jika Anda tidak mengonfigurasi namespaceSelector maupun objectSelector untuk suatu selector tetapi mengonfigurasi effect, pengaturan effect tersebut berlaku untuk semua Pod yang dijadwalkan ke ECI.

• Jika beberapa selector cocok dengan suatu Pod, mereka dievaluasi secara berurutan. Anotasi dan label dari selector yang cocok lebih awal memiliki prioritas lebih tinggi daripada yang cocok kemudian. Namun, anotasi dan label Pod yang sudah ada selalu memiliki prioritas lebih tinggi daripada yang disuntikkan oleh effect.

Lihat eci-profile

Jalankan perintah berikut untuk melihat ConfigMap eci-profile saat ini:

kubectl get cm -n kube-system eci-profile -o yaml

Bagian data dari ConfigMap berisi dua jenis konfigurasi:

Contoh eci-profile default tampak seperti berikut:

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

Edit eci-profile

Gunakan salah satu metode berikut untuk mengedit eci-profile.

kubectl

kubectl edit configmap eci-profile -n kube-system

Konsol ACK

1. Masuk ke Konsol Container Service ACK.

2. Pada halaman Clusters, klik nama kluster target.

3. Di panel navigasi kiri, pilih Configurations > ConfigMaps.

4. Pilih kube-system dari daftar drop-down Namespace.

5. Temukan eci-profile dan klik Edit YAML di kolom Actions.

Konfigurasikan selector

Selector menentukan Pod mana yang diarahkan ke ECI (ECI Scheduler) dan anotasi atau label mana yang disuntikkan ke Pod tersebut (ECI Effect). Saat sebuah Pod dibuat, sistem mengevaluasi setiap selector secara berurutan dan menerapkan aturan yang sesuai.

Setiap selector mendukung bidang berikut:

• `name` (wajib) — Nama unik untuk selector.

• `namespaceSelector` (opsional) — Mencocokkan Pod berdasarkan label namespace. Tentukan label di bawah matchLabels. Beberapa label menggunakan logika AND.

• `objectSelector` (opsional) — Mencocokkan Pod berdasarkan label Pod. Tentukan label di bawah matchLabels. Beberapa label menggunakan logika AND.

• `effect` (opsional) — Anotasi dan label yang akan disuntikkan ke Pod yang cocok. Nilai yang disuntikkan tidak menimpa anotasi atau label Pod yang sudah ada.

data:
  selectors: |
    [
      {
        "name": "selector-demo1",         # Wajib. Nama selector unik.
        "namespaceSelector": {            # Opsional. Mencocokkan berdasarkan label namespace.
          "matchLabels": {                # Logika AND antar beberapa label.
            "eci": "true"
          }
        },
        "objectSelector": {               # Opsional. Mencocokkan berdasarkan label Pod.
          "matchLabels": {                # Logika AND antar beberapa label.
            "eci": "true"
          }
        },
        "effect": {                       # Opsional. Anotasi dan label yang akan disuntikkan.
          "annotations": {
            "k8s.aliyun.com/eci-use-specs": "ecs.c6.xlarge"
          },
          "labels": {
            "created-by-eci": "true"
          }
        }
      },
      {
        "name": "selector-demo2",
        "objectSelector": {
          "matchLabels": {
            "eci": "test"
          }
        }
      }
    ]

kubectl get mutatingwebhookconfigurations -o yaml vk-webhook

Contoh konfigurasi

data:
  selectors: |
    [
      {
        "name": "eci-selector",
        "namespaceSelector": {
          "matchLabels": {
            "type": "eci"
          }
        },
        "objectSelector": {
          "matchLabels": {
            "created-by-eci": "true"
          }
        }
      }
    ]

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"
          }
        }
      }
    ]

data:
  selectors: |
    [
      {
        "name": "autoimc-object-selector",
        "objectSelector": {
          "matchLabels": {
            "imc": "auto"
          }
        },
        "effect": {
          "annotations": {
            "k8s.aliyun.com/eci-auto-imc": "true"
          }
        }
      }
    ]

Perbarui parameter tingkat kluster

Parameter berikut dalam bagian data merupakan nilai default tingkat kluster. Saat sebuah Pod dibuat tanpa penggantian tingkat Pod, nilai dari eci-profile digunakan. Semua parameter mendukung pembaruan panas—perubahan langsung berlaku tanpa perlu merestart ack-virtual-node.

Parameter ini hanya berlaku jika tidak ada konfigurasi tingkat Pod yang menggantikannya.

Tentang `featureGates: WaitForFirstConsumer`

Saat WaitForFirstConsumer diatur ke "true":

• Add-on csi-provisioner harus menggunakan versi terbaru sebelum mengaktifkan pengaturan ini.

• PersistentVolume (PV) dan penyimpanan backend hanya dibuat setelah Pod dijadwalkan. Zona dan wilayah yang ditentukan dalam StorageClass tidak lagi digunakan; sebagai gantinya, zona dan wilayah node tempat Pod dijadwalkan digunakan untuk membuat sumber daya penyimpanan. Hal ini memastikan sumber daya komputasi dijadwalkan secara optimal.

Untuk informasi lebih lanjut, lihat Volume binding mode.

Contoh lengkap bagian data:

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