Pahami Anotasi Pod ECI dalam ACK Serverless - ACK

Tambahkan anotasi ke pod yang berjalan sebagai Elastic Container Instance (ECI) untuk mengaktifkan fitur-fitur ECI tertentu—seperti harga spot, IP tetap, cache gambar, dan binding Elastic IP Address (EIP). Halaman ini mencantumkan semua anotasi yang didukung, dikelompokkan berdasarkan kategori, serta mengidentifikasi anotasi yang ditambahkan saat pembuatan pod dan anotasi yang dihasilkan sistem setelah penjadwalan.

Catatan penggunaan

Anotasi hanya berlaku untuk pod yang dijadwalkan ke virtual nodes. Anotasi tidak berpengaruh pada pod yang dijadwalkan ke real nodes.
Tambahkan anotasi ke spec.template.metadata.annotations dalam manifes workload Anda. Misalnya, saat membuat Deployment, tambahkan anotasi di bagian spec.template.metadata.
Anotasi hanya berlaku saat pod dibuat. Menambahkan atau mengubah anotasi pada pod yang sudah ada tidak akan berpengaruh.

Contoh: Deployment dengan anotasi ECI

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
      annotations:                                    # Anotasi ditempatkan di sini, bukan di level Deployment
        k8s.aliyun.com/eci-use-specs: "2-4Gi"        # Ukuran Pod: 2 vCPU, 4 GiB memori
        k8s.aliyun.com/eci-spot-strategy: SpotAsPriceGo  # Gunakan harga spot
    spec:
      containers:
      - name: nginx
        image: nginx:latest

Anotasi yang dapat Anda tambahkan saat membuat pod

Instans

Fitur	Anotasi	Contoh	Deskripsi
Konfigurasikan beberapa zona untuk membuat pod	`k8s.aliyun.com/eci-vswitch`	`vsw-bp1xpiowfm5vo8o3c****`	ID vSwitch. Tentukan beberapa ID agar pod dapat dibuat di zona mana pun yang memiliki resource tersedia.
	`k8s.aliyun.com/eci-schedule-strategy`	`VSwitchOrdered`	Kebijakan penjadwalan ketika beberapa vSwitch ditentukan. `VSwitchOrdered`: coba vSwitch sesuai urutan yang tercantum. `VSwitchRandom`: pilih vSwitch secara acak.
Buat pod dengan menentukan beberapa spesifikasi / Tentukan jumlah vCPU dan ukuran memori / Tentukan tipe instans ECS	`k8s.aliyun.com/eci-use-specs`	`2-4Gi,4-8Gi,ecs.c6.xlarge`	Satu atau beberapa spesifikasi pod. Menerima kombinasi vCPU-memori (misalnya, `2-4Gi`) atau tipe instans Elastic Compute Service (ECS) (misalnya, `ecs.c6.xlarge`), atau campuran keduanya.
	`k8s.aliyun.com/eci-gpu-driver-version`	`tesla=525.85.12`	Versi driver GPU untuk keluarga instans ECS yang dipercepat GPU yang mendukung beberapa versi driver GPU dan CUDA.
Tentukan atau kecualikan keluarga instans ECS	`k8s.aliyun.com/eci-instance-family`	`"ecs.c6,ecs.g6"`	Menentukan atau mengecualikan keluarga instans ECS ketika ukuran pod ditetapkan berdasarkan vCPU dan memori.
Tentukan atau kecualikan generasi keluarga instans ECS	`k8s.aliyun.com/eci-instance-generation`	`"6,5"`	Menentukan atau mengecualikan generasi tertentu dari keluarga instans ECS ketika ukuran pod ditetapkan berdasarkan vCPU dan memori.
Tentukan kategori komputasi	`k8s.aliyun.com/eci-compute-category`	`economy`	Kategori komputasi yang diterapkan ketika ukuran pod ditetapkan berdasarkan vCPU dan memori. Nilai yang valid: `economy`, `general`. Tentukan beberapa nilai sesuai preferensi; sistem akan memilih kategori pertama yang tersedia.
Buat instans preemptible	`k8s.aliyun.com/eci-spot-strategy`	`SpotAsPriceGo`	Kebijakan penawaran untuk instans preemptible. `SpotAsPriceGo`: gunakan harga pasar saat ini secara otomatis. `SpotWithPriceLimit`: batasi harga per jam (juga atur `eci-spot-price-limit`).
	`k8s.aliyun.com/eci-spot-price-limit`	`"0.5"`	Harga maksimum per jam untuk instans preemptible, akurat hingga tiga tempat desimal. Diperlukan ketika `eci-spot-strategy` adalah `SpotWithPriceLimit`.
	`k8s.aliyun.com/eci-spot-duration`	`"0"`	Periode perlindungan untuk instans preemptible. Satuan: jam. Default: `1`. Atur ke `0` untuk tanpa periode perlindungan.
	`k8s.aliyun.com/eci-spot-fallback`	`"true"`	Apakah akan kembali ke instans pay-as-you-go jika inventaris spot tidak mencukupi. Default: `false`.
Gunakan private pool dari elasticity assurance	`k8s.aliyun.com/eci-privatepool-matchcriteria`	`"Open"`	Mode pencocokan private pool. `Open`: cocokkan dengan private pool terbuka. `Target`: gunakan private pool tertarget (juga atur `eci-privatepool-id`).
	`k8s.aliyun.com/eci-privatepool-id`	`eap-2ze1g68k2melxkkl****`	ID private pool (ID elasticity assurance). Dapatkan dari tab Resource Reservations atau Private Pools di Konsol ECS. Diperlukan ketika `eci-privatepool-matchcriteria` adalah `Target`; tidak berpengaruh jika diatur ke `Open`.
Konfigurasikan kebijakan penanganan kesalahan	`k8s.aliyun.com/eci-fail-strategy`	`fail-back`	Apa yang terjadi ketika pod gagal dibuat. `fail-back` atau `fail-over`: coba ulang pembuatan pod secara otomatis. `fail-fast`: laporkan error segera.
Atur durasi pending maksimum	`k8s.aliyun.com/eci-max-pending-minute`	`"30"`	Berapa lama pod dapat berada dalam status pending sebelum sistem menghentikannya. Nilai yang valid: `10`–`1440`. Satuan: menit. Default: `240`.
Konfigurasikan /etc/hosts	`k8s.aliyun.com/eci-custom-hosts`	`"[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"`	Entri kustom untuk file `/etc/hosts` pod.
Bind tag kustom	`k8s.aliyun.com/eci-custom-tags`	`"env:test,name:alice"`	Tag kustom untuk dilampirkan ke pod. Maksimal tiga tag. Format: `key:value`, dipisahkan koma.
Tetapkan peran RAM	`k8s.aliyun.com/eci-ram-role-name`	`AliyunECIContainerGroupRole`	Peran RAM yang diasumsikan pod untuk mengakses layanan Alibaba Cloud lainnya.

Contoh instans spot

Gunakan anotasi-anotasi ini secara bersamaan saat membuat instans preemptible dengan batas harga:

annotations:
  k8s.aliyun.com/eci-spot-strategy: SpotWithPriceLimit  # Batasi harga per jam
  k8s.aliyun.com/eci-spot-price-limit: "0.5"             # Harga maksimum: 0,500/jam
  k8s.aliyun.com/eci-spot-fallback: "true"               # Kembali ke pay-as-you-go jika spot tidak tersedia

Contoh pool pribadi

Gunakan anotasi-anotasi ini secara bersamaan saat menggunakan private pool tertarget:

annotations:
  k8s.aliyun.com/eci-privatepool-matchcriteria: Target
  k8s.aliyun.com/eci-privatepool-id: eap-2ze1g68k2melxkkl****  # Diperlukan ketika matchcriteria adalah Target

Gambar

Fitur	Anotasi	Contoh	Deskripsi
Percepat pembuatan pod dengan cache gambar	`k8s.aliyun.com/eci-auto-imc`	`"true"`	Apakah akan mencocokkan cache gambar secara otomatis.
	`k8s.aliyun.com/imc-perfect-match`	`"true"`	Apakah semua gambar kontainer dalam pod harus persis sesuai dengan cache gambar.
	`k8s.aliyun.com/imc-match-count-request`	`"2"`	Jumlah gambar kontainer yang harus persis sesuai dengan cache gambar.
	`k8s.aliyun.com/eci-imc-id`	`imc-2zebxkiifuyzzlhl****`	ID cache gambar tertentu yang akan digunakan.
Tarik gambar tanpa rahasia (Container Registry Edisi Perusahaan)	`k8s.aliyun.com/acr-instance-ids`	`cri-j36zhodptmyq****`	ID instans Container Registry Edisi Perusahaan untuk penarikan gambar tanpa rahasia. Untuk penarikan lintas wilayah, tambahkan awalan ID wilayah: `"cn-beijing:cri-j36zhodptmyq****"`.
	`k8s.aliyun.com/acr-service-arns`	`acs:ram::1609982529******:role/role-assume`	Nama Sumber Daya Alibaba Cloud (ARN) dari peran RAM di akun Alibaba Cloud tempat resource ECI berada. Diperlukan saat menggunakan peran RAM untuk membuat resource.
	`k8s.aliyun.com/acr-user-arns`	`acs:ram::1298452580******:role/role-acr`	ARN dari peran RAM di akun Alibaba Cloud tempat instans Container Registry berada. Diperlukan saat menarik gambar dari instans Container Registry yang dimiliki oleh akun Alibaba Cloud berbeda.
Tarik dari repository gambar yang dikelola sendiri (HTTP)	`k8s.aliyun.com/plain-http-registry`	`harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80`	Alamat repository gambar yang dikelola sendiri yang menggunakan HTTP biasa. ECI menarik gambar melalui HTTP alih-alih HTTPS default, mencegah kegagalan ketidakcocokan protokol.
Tarik dari repository gambar yang dikelola sendiri (sertifikat tanda tangan sendiri)	`k8s.aliyun.com/insecure-registry`	`harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80`	Alamat repository gambar yang dikelola sendiri yang menggunakan sertifikat tanda tangan sendiri. ECI melewati verifikasi sertifikat, mencegah kegagalan autentikasi.

Cache data

Fitur	Anotasi	Contoh	Deskripsi
Buat pod menggunakan DataCache	`k8s.aliyun.com/eci-data-cache-bucket`	`default`	Bucket yang menyimpan DataCache. Diperlukan saat menggunakan DataCache untuk membuat pod.
	`k8s.aliyun.com/eci-data-cache-pl`	`PL1`	Tingkat performa disk yang dibuat dari DataCache. Default: SSD ditingkatkan (ESSD) `PL1`.
	`k8s.aliyun.com/eci-data-cache-provisionedIops`	`"40000"`	IOPS baca/tulis yang dialokasikan untuk disk ESSD AutoPL. Rentang valid: `0` hingga `min{50.000, 1000 × kapasitas penyimpanan − IOPS garis dasar}`, dengan IOPS garis dasar = `min{1800 + 50 × kapasitas penyimpanan, 50000}`. Menambahkan anotasi ini menjadikan disk sebagai disk ESSD AutoPL. Lihat disk ESSD AutoPL.
	`k8s.aliyun.com/eci-data-cache-burstingEnabled`	`"true"`	Apakah akan mengaktifkan fitur lonjakan performa untuk disk ESSD AutoPL. Menambahkan anotasi ini menjadikan disk sebagai disk ESSD AutoPL. Lihat disk ESSD AutoPL.

Jaringan

Fitur	Anotasi	Contoh	Deskripsi
Tetapkan grup keamanan	`k8s.aliyun.com/eci-security-group`	`sg-bp1dktddjsg5nktv****`	ID grup keamanan. Maksimal lima grup. Semua grup harus berada dalam virtual private cloud (VPC) yang sama dan bertipe sama.
Asosiasikan EIP	`k8s.aliyun.com/eci-eip-instanceid`	`eip-bp1q5n8cq4p7f6dzu****`	ID EIP yang sudah ada untuk diasosiasikan dengan instans.
	`k8s.aliyun.com/eci-with-eip`	`"true"`	Apakah akan secara otomatis membuat EIP dan mengasosiasikannya saat instans dibuat.
	`k8s.aliyun.com/eip-bandwidth`	`"5"`	Bandwidth maksimum EIP. Satuan: Mbit/s. Default: `5`.
	`k8s.aliyun.com/eip-common-bandwidth-package-id`	`cbwp-2zeukbj916scmj51m****`	ID paket bandwidth EIP yang sudah ada untuk diasosiasikan dengan instans. Lihat Apa itu Bandwidth Internet Bersama?
	`k8s.aliyun.com/eip-isp`	`BGP`	Jenis jalur untuk EIP. Hanya berlaku untuk EIP pay-as-you-go. `BGP`: jalur BGP (Multi-ISP). `BGP_PRO`: jalur BGP (Multi-ISP) Pro. Lihat Apa itu EIP.
	`k8s.aliyun.com/eip-internet-charge-type`	`PayByBandwidth`	Metode penagihan EIP. `PayByBandwidth`: bayar-per-bandwidth. `PayByTraffic`: bayar-per-lalu-lintas. Lihat Ikhtisar penagihan.
	`k8s.aliyun.com/eip-public-ip-address-pool-id`	`pippool-bp187arfugi543y1s****`	ID kolam alamat IP tempat EIP dialokasikan. Lihat Buat dan kelola kolam alamat IP.
Tetapkan alamat IPv6	`k8s.aliyun.com/eci-enable-ipv6`	`"true"`	Apakah akan menetapkan alamat IPv6 ke pod.
	`k8s.aliyun.com/eci-ipv6-bandwidth-enable`	`"true"`	Apakah akan mengaktifkan akses internet melalui alamat IPv6.
	`k8s.aliyun.com/eci-ipv6-bandwidth`	`100M`	Bandwidth publik puncak alamat IPv6.
Tentukan alamat IP pribadi	`k8s.aliyun.com/eci-private-ip-address`	`"172.16.0.1"`	Alamat IP pribadi untuk pod. Hanya IPv4 yang didukung. Alamat tersebut harus belum digunakan.
Gunakan alamat IP tetap	`k8s.aliyun.com/eci-fixed-ip`	`"true"`	Apakah akan menetapkan alamat IP tetap ke pod.
	`k8s.aliyun.com/eci-fixed-ip-retain-hour`	`"24"`	Berapa lama alamat IP tetap dipertahankan setelah pod dilepas dan IP menjadi idle. Satuan: jam. Default: `48`.
Batasi bandwidth arah masuk dan keluar	`kubernetes.io/ingress-bandwidth`	`40M`	Bandwidth maksimum arah masuk.
	`kubernetes.io/egress-bandwidth`	`20M`	Bandwidth maksimum arah keluar.
Konfigurasikan server DNS kustom	`k8s.aliyun.com/eci-custom-dnsconfig`	`"{\"nameservers\":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}"`	Konfigurasi DNS kustom untuk pod. Digunakan dalam skenario cloud hibrida untuk menyelesaikan nama domain internal.

Contoh EIP

Gunakan anotasi-anotasi ini secara bersamaan saat membuat dan mengasosiasikan EIP secara otomatis:

annotations:
  k8s.aliyun.com/eci-with-eip: "true"                  # Buat EIP secara otomatis
  k8s.aliyun.com/eip-bandwidth: "10"                   # Bandwidth 10 Mbit/s
  k8s.aliyun.com/eip-internet-charge-type: PayByTraffic # Tagih berdasarkan trafik

Contoh IPv6

Gunakan anotasi-anotasi ini secara bersamaan untuk mengaktifkan IPv6 dengan akses internet:

annotations:
  k8s.aliyun.com/eci-enable-ipv6: "true"           # Tetapkan alamat IPv6
  k8s.aliyun.com/eci-ipv6-bandwidth-enable: "true"  # Aktifkan akses internet melalui IPv6
  k8s.aliyun.com/eci-ipv6-bandwidth: "100M"         # Bandwidth puncak: 100 Mbit/s

Penyimpanan

Fitur	Anotasi	Contoh	Deskripsi
Tingkatkan kapasitas penyimpanan sementara	`k8s.aliyun.com/eci-extra-ephemeral-storage`	`50Gi`	Ukuran ruang penyimpanan sementara.
Enkripsi penyimpanan sementara	`k8s.aliyun.com/eci-ephemeral-storage-options`	`"{\"encrypted\":\"true\"}"`	Opsi untuk ruang penyimpanan sementara. Atur ke `{"encrypted":"true"}` untuk mengaktifkan enkripsi.
Evaksi otomatis pod dengan penyimpanan sementara tidak mencukupi	`k8s.aliyun.com/eci-eviction-enable`	`"true"`	Apakah akan secara otomatis mengevaksi pod yang kehabisan ruang penyimpanan sementara.

Konfigurasi kontainer

Fitur	Anotasi	Contoh	Deskripsi
Konfigurasikan layanan NTP	`k8s.aliyun.com/eci-ntp-server`	`100.100..`	Alamat IP server Network Time Protocol (NTP).

Log

Fitur	Anotasi	Contoh	Deskripsi
Kumpulkan log menggunakan CRD Layanan Log Sederhana	`k8s.aliyun.com/eci-sls-enable`	`"false"`	Apakah akan mengaktifkan pengumpulan log. Atur ke `false` untuk mengecualikan pod tertentu dari pengumpulan log saat menggunakan definisi sumber daya kustom (CRD) Layanan Log Sederhana, mencegah pembuatan instance Logtail yang tidak perlu.

O&M

Fitur	Anotasi	Contoh	Deskripsi
Lihat file core dump	`k8s.aliyun.com/eci-core-pattern`	`/pod/data/dump/core`	Direktori tempat file core dump disimpan.

Anotasi yang ditambahkan setelah penjadwalan

Setelah sistem menjadwalkan resource dan membuat pod, anotasi-anotasi berikut akan ditambahkan secara otomatis. Jalankan kubectl describe pod <nama-pod> untuk melihatnya.

Anotasi	Contoh	Deskripsi
`k8s.aliyun.com/eci-request-id`	`45942504-4688-51BA-BBAB-4B692C4F39C0`	ID permintaan untuk panggilan pembuatan pod.
`k8s.aliyun.com/eci-instance-id`	`eci-2ze1y0la40qgva09****`	ID instans ECI dari pod.
`k8s.aliyun.com/eci-instance-spec`	`2.0-4.0Gi`	Spesifikasi aktual pod. Jika nilainya berupa pasangan vCPU-memori (misalnya, `2.0-4.0Gi`), penagihan didasarkan pada vCPU dan memori. Jika nilainya berupa tipe instans ECS (misalnya, `ecs.c6.large`), penagihan didasarkan pada tipe instans tersebut.
`k8s.aliyun.com/eci-instance-compute-category`	`economy`	Kategori komputasi dari tipe instans ECS yang digunakan untuk pod. `economy`: ditagih dengan tarif kategori ekonomis. `general`: ditagih dengan tarif kategori umum.
`k8s.aliyun.com/allocated-eipInstanceId`	`eip-bp1q5n8cq4p7f6dzu****`	ID EIP yang diasosiasikan dengan instans.
`k8s.aliyun.com/allocated-eipAddress`	`47.99..`	Alamat IP publik dari EIP yang diasosiasikan.
`k8s.aliyun.com/allocated-ipv6Address`	`2001:d**:1:1:1:1:1:1`	Alamat IPv6 yang ditetapkan ke pod.
`k8s.aliyun.com/eci-created-by-template`	`true`	Apakah pod dibuat dari templat.
`k8s.aliyun.com/eni-instance-id`	`eni-2ze6d7oo5ukqj26o****`	ID antarmuka jaringan elastis (ENI) yang diikat ke pod.
`k8s.aliyun.com/eci-vpc`	`vpc-2zeghwzptn5zii0w7****`	ID VPC tempat pod berada.
`k8s.aliyun.com/eci-matched-image-cache`	`imc-2zedy3v37800iimu****`	ID cache gambar yang dicocokkan selama pembuatan pod.
`k8s.aliyun.com/eci-schedule-result`	`finished`	Hasil penjadwalan. Telah ditinggalkan. Untuk status penjadwalan pod saat ini, lihat ContainerInstanceCreated.