Anotasi apa saja yang didukung oleh ECI? - Elastic Container Instance

Saat membuat pod ECI (Elastic Container Instance) di kluster Kubernetes, Anda dapat menambahkan anotasi untuk memanfaatkan fitur-fitur ECI tanpa mengubah semantik Kubernetes. Topik ini mencakup anotasi yang dapat Anda tambahkan serta anotasi yang ditambahkan secara otomatis setelah penjadwalan pod.

Anotasi pod ECI

Pod ECI mendukung anotasi berikut:

Penting

Anotasi ini hanya berlaku untuk Pod yang dijadwalkan pada node virtual (Elastic Container Instance) dan tidak memengaruhi Pod pada node biasa.
Tambahkan anotasi ke metadata Pod. Misalnya, saat membuat Deployment, tambahkan anotasi di bawah spec>template>metadata.
Anotasi terkait Elastic Container Instance hanya diterapkan saat pod dibuat. Menambahkan atau mengubah anotasi ini pada pod yang sudah ada tidak akan berpengaruh.

Contoh

Fitur	Anotasi	Nilai contoh	Deskripsi
Buat pod di beberapa zona ketersediaan	k8s.aliyun.com/eci-vswitch	vsw-bp1xpiowfm5vo8o3c****	Menentukan ID vSwitch. Anda dapat menentukan beberapa ID vSwitch untuk men-deploy pod di beberapa zona ketersediaan.
Buat pod di beberapa zona ketersediaan	k8s.aliyun.com/eci-schedule-strategy	VSwitchOrdered	Kebijakan penjadwalan untuk beberapa zona ketersediaan. Nilai yang valid: `VSwitchOrdered`: Mencoba membuat pod menggunakan vSwitch yang ditentukan sesuai urutan daftarnya. `VSwitchRandom`: Membuat pod di salah satu vSwitch yang ditentukan, dipilih berdasarkan kebijakan penjadwalan optimal Alibaba Cloud.
Buat pod dengan beberapa spesifikasi instans Buat pod dengan menentukan vCPU dan memori Buat pod dengan menentukan tipe instans ECS	k8s.aliyun.com/eci-use-specs	2-4Gi,4-8Gi,ecs.c6.xlarge	Menentukan satu atau beberapa spesifikasi instans untuk pod ECI, yang dapat berupa kombinasi vCPU dan memori atau tipe instans ECS.
	k8s.aliyun.com/eci-gpu-driver-version	tesla=525.85.12	Menentukan versi driver GPU. Saat Anda membuat instans GPU-accelerated dengan menentukan tipe instans GPU yang mendukung beberapa versi driver dan CUDA, gunakan anotasi ini untuk menentukan versi driver dan CUDA.
Buat pod dengan menentukan atau mengecualikan family instans ECS	k8s.aliyun.com/eci-instance-family	"ecs.c6,ecs.g6"	Menentukan family instans ECS mana yang digunakan atau dihindari saat membuat instans ECI berdasarkan kebutuhan vCPU dan memori.
Buat pod dengan menentukan atau mengecualikan generasi instans ECS	k8s.aliyun.com/eci-instance-generation	"6,5"	Menentukan generasi instans ECS mana yang digunakan atau dihindari saat membuat instans ECI berdasarkan kebutuhan vCPU dan memori.
Buat pod dengan menentukan kategori komputasi	k8s.aliyun.com/eci-compute-category	economy	Menentukan kategori komputasi saat Anda membuat instans ECI dengan menentukan vCPU dan memori.
Buat instans preemptible	k8s.aliyun.com/eci-spot-strategy	SpotAsPriceGo	Kebijakan penawaran untuk instans preemptible. Nilai yang valid: `SpotWithPriceLimit`: Menetapkan harga maksimum kustom untuk instans preemptible. Kebijakan ini mengharuskan Anda juga menyetel anotasi `k8s.aliyun.com/eci-spot-price-limit`. `SpotAsPriceGo`: Sistem secara otomatis menawar dengan harga pasar saat ini.
	k8s.aliyun.com/eci-spot-price-limit	"0.5"	Harga maksimum per jam untuk instans preemptible. Nilai ini mendukung hingga tiga tempat desimal. Anotasi ini hanya berlaku ketika `k8s.aliyun.com/eci-spot-strategy` disetel ke `SpotWithPriceLimit`.
	k8s.aliyun.com/eci-spot-duration	"0"	Periode perlindungan untuk instans preemptible. Nilai default adalah 1 jam. Tetapkan nilai ke 0 untuk tanpa periode perlindungan.
	k8s.aliyun.com/eci-spot-fallback	"true"	Menentukan apakah akan secara otomatis membuat instans pay-as-you-go ketika instans preemptible tidak tersedia. Nilai default adalah `false`.
Buat pod menggunakan private pool dengan Elasticity Assurance	k8s.aliyun.com/eci-privatepool-matchcriteria	"Open"	Setel mode pencocokan private pool. Nilai yang valid: Open: Sistem secara otomatis mencocokkan private pool terbuka yang tersedia. Target: Anda juga harus menentukan ID private pool. Gunakan mode ini jika private pool Anda bersifat dedicated.
	k8s.aliyun.com/eci-privatepool-id	eap-2ze1g68k2melxkkl****	Tentukan ID private pool (yaitu ID elasticity assurance). Temukan di halaman Resource reservation di Konsol ECS pada tab Resource Reservations atau Private Pools. Jika k8s.aliyun.com/eci-privatepool-matchcriteria disetel ke Target, Anda harus menyertakan anotasi ini. Jika k8s.aliyun.com/eci-privatepool-matchcriteria disetel ke Open, anotasi ini tidak berpengaruh.
Tetapkan kebijakan penanganan kesalahan untuk pod ECI	k8s.aliyun.com/eci-fail-strategy	fail-back	Kebijakan penanganan kesalahan untuk pod ECI. Nilai yang valid: `fail-back`: Jika pembuatan pod gagal, sistem secara otomatis mencoba ulang. `fail-over`: Sama seperti `fail-back`. `fail-fast`: Jika pembuatan pod gagal, sistem segera melaporkan error.
Kustomisasi durasi pending maksimum untuk pod ECI	k8s.aliyun.com/eci-max-pending-minute	"30"	Waktu maksimum dalam menit yang boleh dihabiskan instans ECI untuk pod dalam status `Pending`. Jika melebihi batas waktu tersebut, sistem akan menghentikan instans. Nilainya harus berupa bilangan bulat antara 10 hingga 1440. Default: 240 (4 jam).
Kustomisasi host untuk pod ECI	k8s.aliyun.com/eci-custom-hosts	"[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"	Menambahkan pemetaan host kustom ke file `/etc/hosts` pod ECI.
Bind tag kustom ke pod ECI	k8s.aliyun.com/eci-custom-tags	"env:test,name:alice"	Menentukan hingga tiga tag untuk di-bind ke pod. Tag berupa pasangan kunci-nilai yang dipisahkan tanda titik dua (:) dan beberapa tag dipisahkan tanda koma (,).
Bind peran RAM ke pod ECI	k8s.aliyun.com/eci-ram-role-name	AliyunECIContainerGroupRole	Meng-bind peran RAM ke pod ECI, memberikan izin untuk mengakses layanan Alibaba Cloud lainnya.

Gambar

Fitur	Parameter	Nilai	Deskripsi
Percepat pembuatan pod dengan cache gambar	k8s.aliyun.com/eci-auto-imc	"true"	Setel ke `"true"` untuk mencocokkan cache gambar secara otomatis.
	k8s.aliyun.com/imc-perfect-match	"true"	Jika pencocokan otomatis diaktifkan, tentukan apakah semua gambar kontainer dalam pod harus persis cocok dengan gambar dalam cache.
	k8s.aliyun.com/imc-match-count-request	"2"	Jika pencocokan otomatis diaktifkan, tentukan jumlah gambar kontainer dalam pod yang harus persis cocok dengan gambar dalam cache.
	k8s.aliyun.com/eci-imc-id	imc-2zebxkiifuyzzlhl****	Menentukan ID cache gambar.
Tarik gambar ACR tanpa Secret	k8s.aliyun.com/acr-instance-ids	cri-j36zhodptmyq****	Menentukan instance Container Registry Enterprise Edition tempat menarik gambar tanpa Secret. Untuk menarik gambar dari wilayah berbeda, tambahkan awalan ID wilayah pada ID instance. Contoh: `"cn-beijing:cri-j36zhodptmyq****"`.
	k8s.aliyun.com/acr-service-arns	acs:ram::1609982529******:role/role-assume	Menentukan ARN peran RAM di akun yang memiliki resource ECI. Anotasi ini diperlukan jika Anda menggunakan peran RAM untuk membuat resource.
	k8s.aliyun.com/acr-user-arns	acs:ram::1298452580******:role/role-acr	Menentukan ARN peran RAM yang dimiliki oleh akun instance Container Registry Enterprise Edition. Anotasi ini diperlukan untuk menarik gambar dari akun berbeda.
Tarik gambar dari repository gambar yang dikelola sendiri	k8s.aliyun.com/plain-http-registry	harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80	Mengizinkan ECI menarik gambar melalui HTTP dari repository gambar yang dikelola sendiri yang ditentukan. Ini mencegah kegagalan tarik akibat ketidakcocokan protokol.
Tarik gambar dari repository gambar yang dikelola sendiri	k8s.aliyun.com/insecure-registry	harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80	Melewati verifikasi sertifikat saat menarik gambar dari repository gambar yang dikelola sendiri yang ditentukan. Ini mencegah kegagalan tarik akibat sertifikat tanda tangan sendiri.

DataCache

Fitur	Parameter	Nilai	Deskripsi
Buat pod dari DataCache	k8s.aliyun.com/eci-data-cache-bucket	default	Menentukan bucket yang digunakan untuk menyimpan DataCache. Anda harus mengonfigurasi anotasi ini saat menggunakan DataCache untuk membuat pod.
	k8s.aliyun.com/eci-data-cache-pl	PL1	Menentukan tingkat kinerja disk yang dibuat berdasarkan DataCache. Secara default, digunakan ESSD PL1 yang ditingkatkan.
	k8s.aliyun.com/eci-data-cache-provisionedIops	"40000"	Menentukan IOPS baca/tulis yang disediakan untuk disk ESSD AutoPL. Nilai yang valid: 0 hingga min{50000, 1000 × Kapasitas penyimpanan - IOPS baseline}. IOPS baseline = min{1.800 + 50 × Kapasitas penyimpanan, 50.000}. Untuk informasi lebih lanjut, lihat disk ESSD AutoPL. Jika Anda menambahkan anotasi ini, disk yang dibuat berdasarkan DataCache adalah disk ESSD AutoPL.
	k8s.aliyun.com/eci-data-cache-burstingEnabled	"true"	Menentukan apakah akan mengaktifkan fitur lonjakan performa untuk disk ESSD AutoPL. Untuk informasi lebih lanjut, lihat disk ESSD AutoPL. Jika Anda menambahkan anotasi ini, disk yang dibuat berdasarkan DataCache adalah disk ESSD AutoPL.

Jaringan

Fitur	Parameter	Nilai contoh	Deskripsi
Konfigurasikan security group untuk pod ECI	k8s.aliyun.com/eci-security-group	sg-bp1dktddjsg5nktv****	Menentukan ID security group. Persyaratan berikut berlaku:
Asosiasikan EIP dengan instans ECI	k8s.aliyun.com/eci-eip-instanceid	eip-bp1q5n8cq4p7f6dzu****	ID EIP yang akan diasosiasikan.
	k8s.aliyun.com/eci-with-eip	"true"	Membuat dan mengasosiasikan EIP secara otomatis jika disetel ke "true".
	k8s.aliyun.com/eip-bandwidth	"5"	Bandwidth EIP dalam Mbps. Default-nya adalah 5 Mbps.
	k8s.aliyun.com/eip-common-bandwidth-package-id	cbwp-2zeukbj916scmj51m****	ID Paket Bandwidth Umum yang sudah ada. Untuk informasi lebih lanjut, lihat Shared Bandwidth.
	k8s.aliyun.com/eip-isp	BGP	Jenis jalur EIP. Pengaturan ini hanya berlaku untuk EIP pay-as-you-go. Nilai yang valid: BGP: BGP (Multi-ISP) BGP_PRO: BGP (Multi-ISP) Pro Untuk informasi lebih lanjut, lihat jenis jalur EIP.
	k8s.aliyun.com/eip-internet-charge-type	PayByBandwidth	Metode penagihan EIP. Nilai yang valid: PayByBandwidth: bayar-per-bandwidth PayByTraffic: bayar-per-lalu-lintas Untuk informasi lebih lanjut, lihat metode penagihan EIP.
	k8s.aliyun.com/eip-public-ip-address-pool-id	pippool-bp187arfugi543y1s****	ID kolam alamat IP tempat mengalokasikan EIP. Untuk informasi lebih lanjut, lihat kolam alamat IP.
Tetapkan alamat IPv6 ke pod ECI	k8s.aliyun.com/eci-enable-ipv6	"true"	Menetapkan alamat IPv6 ke pod jika disetel ke "true".
	k8s.aliyun.com/eci-ipv6-bandwidth-enable	"true"	Mengaktifkan akses internet publik untuk alamat IPv6 instans ECI jika disetel ke "true".
	k8s.aliyun.com/eci-ipv6-bandwidth	100M	Bandwidth publik puncak untuk alamat IPv6, dalam Mbps.
Tentukan alamat IP pribadi untuk pod ECI	k8s.aliyun.com/eci-private-ip-address	"172.16.0.1"	Menentukan alamat IP pribadi untuk pod. Hanya alamat IPv4 yang didukung. Pastikan alamat IP tersebut tidak sedang digunakan.
Konfigurasikan alamat IP tetap untuk pod ECI	k8s.aliyun.com/eci-fixed-ip	"true"	Mengaktifkan alamat IP tetap untuk pod jika disetel ke "true".
Konfigurasikan alamat IP tetap untuk pod ECI	k8s.aliyun.com/eci-fixed-ip-retain-hour	"24"	Periode retensi dalam jam untuk alamat IP tetap setelah rilis pod. Jika anotasi ini tidak dikonfigurasi, periode retensi default adalah 48 jam.
Batasi bandwidth ingress dan egress pod ECI	kubernetes.io/ingress-bandwidth	40M	Bandwidth ingress maksimum, dalam Mbps.
Batasi bandwidth ingress dan egress pod ECI	kubernetes.io/egress-bandwidth	20M	Bandwidth egress maksimum, dalam Mbps.
Konfigurasikan DNS kustom untuk pod ECI	k8s.aliyun.com/eci-custom-dnsconfig	`{\"nameservers\":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}`	Menentukan pengaturan DNS kustom untuk pod ECI. Biasanya digunakan dalam skenario cloud hibrida untuk menyelesaikan nama domain internal.

Penyimpanan

Fitur	Parameter	Nilai	Deskripsi
Perluas penyimpanan temporary	k8s.aliyun.com/eci-extra-ephemeral-storage	50Gi	Ukuran ruang penyimpanan temporary.
Enkripsi penyimpanan temporary	k8s.aliyun.com/eci-ephemeral-storage-options	"{\"encrypted\":\"true\"}"	Mengaktifkan enkripsi untuk ruang penyimpanan temporary.

Kontainer

Fitur	Parameter	Nilai contoh	Deskripsi
Konfigurasikan layanan NTP untuk pod	k8s.aliyun.com/eci-ntp-server	100.100..*	Menentukan alamat server NTP.

Log

Fitur

Parameter

Nilai contoh

Deskripsi

Kumpulkan log dengan CRD SLS

k8s.aliyun.com/eci-sls-enable

"false"

Setel nilai ke "false" untuk menonaktifkan pengumpulan log.

Saat mengumpulkan log dengan definisi sumber daya kustom (CRD) SLS, tambahkan anotasi ini ke pod yang ingin Anda kecualikan dari pengumpulan log. Tindakan ini mencegah pembuatan konfigurasi Logtail secara otomatis dan menghemat resource.

O&M

Fitur	Parameter	Nilai contoh	Deskripsi
Lihat file core dump	k8s.aliyun.com/eci-core-pattern	/pod/data/dump/core	Direktori tempat menyimpan file core dump.

Anotasi pod ECI

Tabel berikut mencantumkan anotasi yang ditambahkan ke Pod ECI setelah dijadwalkan. Anda dapat mengkueri anotasi ini dengan menjalankan perintah kubectl describe.

Parameter	Nilai contoh	Deskripsi
k8s.aliyun.com/eci-request-id	45942504-4688-51BA-BBAB-4B692C4F39C0	ID permintaan.
k8s.aliyun.com/eci-instance-id	eci-2ze1y0la40qgva09****	ID instans ECI.
k8s.aliyun.com/eci-instance-spec	2.0-4.0Gi	Spesifikasi instans ECI yang digunakan untuk penagihan. Jika nilainya merupakan kombinasi vCPU dan memori tertentu (misalnya, 2.0-4.0Gi), instans ditagih berdasarkan vCPU dan memori. Jika nilainya merupakan tipe instans ECS (misalnya, ecs.c6.large), instans ditagih berdasarkan tipe instans ECS.
k8s.aliyun.com/eci-instance-compute-category	economy	Kategori komputasi dari spesifikasi instans ECI. Jika nilainya `economy`, instans ditagih berdasarkan spesifikasi instans economy. Jika nilainya `general`, instans ditagih berdasarkan spesifikasi instans general purpose.
k8s.aliyun.com/allocated-eipInstanceId	eip-bp1q5n8cq4p7f6dzu****	ID EIP yang diasosiasikan.
k8s.aliyun.com/allocated-eipAddress	47.99..	Alamat IP dari EIP yang diasosiasikan.
k8s.aliyun.com/allocated-ipv6Address	2001:d**:1:1:1:1:1:1	Alamat IPv6 yang diasosiasikan.
k8s.aliyun.com/eci-created-by-template	true	Menunjukkan apakah instans ECI dibuat dari templat.
k8s.aliyun.com/eni-instance-id	eni-2ze6d7oo5ukqj26o****	ID antarmuka jaringan elastis yang diasosiasikan.
k8s.aliyun.com/eci-vpc	vpc-2zeghwzptn5zii0w7****	ID VPC.
k8s.aliyun.com/eci-matched-image-cache	imc-2zedy3v37800iimu****	ID cache gambar yang dicocokkan.
k8s.aliyun.com/eci-schedule-result	finished	Hasil penjadwalan. Anotasi ini sudah tidak digunakan lagi. Sebagai gantinya, rujuk kondisi ContainerInstanceCreated di podStatus.conditions. Untuk informasi lebih lanjut, lihat ContainerInstanceCreated.