全部产品
Search

搜索本产品

    ：Anotasi untuk Pod Berbasis Elastic Container Instance

    文档中心

    ：Anotasi untuk Pod Berbasis Elastic Container Instance

    更新时间：Jul 02, 2025

    Saat membuat pod (instance kontainer elastis) dalam klaster Kubernetes, Anda dapat menambahkan anotasi ke pod untuk memanfaatkan semua fitur Elastic Container Instance. Pastikan anotasi yang ingin ditambahkan sesuai dengan sintaksis Kubernetes. Topik ini menjelaskan anotasi yang dapat ditambahkan saat membuat pod serta anotasi yang dapat ditambahkan setelah sistem mengalokasikan sumber daya dan membuat pod.

    Anotasi yang Dapat Ditambahkan Saat Membuat Pod

    Tabel berikut menjelaskan anotasi yang dapat ditambahkan saat membuat pod berbasis Elastic Container Instance.

    Penting

    • Anotasi dalam tabel berikut hanya berlaku untuk pod yang dijadwalkan ke node virtual. Pod tersebut berjalan sebagai instance kontainer elastis. Anotasi tidak dapat diterapkan pada pod yang dijadwalkan ke node nyata.

    • Anotasi harus ditambahkan ke metadata file konfigurasi pod. Sebagai contoh, saat membuat Deployment, tambahkan anotasi di bagian spec.template.metadata.

    • Untuk menggunakan fitur Elastic Container Instance, Anda hanya dapat menambahkan anotasi saat membuat pod berbasis Elastic Container Instance. Jika Anda menambahkan atau memodifikasi anotasi saat memperbarui pod, anotasi tersebut tidak akan berlaku.

    Instance

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Konfigurasikan beberapa zona untuk membuat pod

    k8s.aliyun.com/eci-vswitch

    vsw-bp1xpiowfm5vo8o3c****

    Menentukan ID vSwitch. Anda dapat menentukan beberapa ID vSwitch untuk memastikan bahwa pod dapat dibuat di zona yang memiliki sumber daya cukup.

    k8s.aliyun.com/eci-schedule-strategy

    VSwitchOrdered

    Mengonfigurasi kebijakan penjadwalan multi-zona. Nilai valid:

    • VSwitchOrdered: Sumber daya di zona yang ditentukan dijadwalkan berdasarkan urutan spesifikasi vSwitch.

    • VSwitchRandom: Sumber daya di zona yang ditentukan dijadwalkan secara acak.

    k8s.aliyun.com/eci-use-specs

    2-4Gi,4-8Gi,ecs.c6.xlarge

    Menentukan satu atau lebih spesifikasi pod. Spesifikasi dapat berupa kombinasi jumlah vCPU dan ukuran memori. Spesifikasi juga dapat berupa tipe instance dari Elastic Compute Service (ECS).

    k8s.aliyun.com/eci-gpu-driver-version

    tesla=525.85.12

    Menentukan versi driver GPU.

    Jika Anda menentukan keluarga instance ECS yang dipercepat GPU yang mendukung beberapa versi driver GPU dan CUDA saat membuat instance kontainer elastis yang dipercepat GPU, Anda dapat mengonfigurasi anotasi ini untuk menentukan versi driver dan CUDA.

    Tentukan atau kecualikan keluarga instance ECS tertentu untuk membuat pod

    k8s.aliyun.com/eci-instance-family

    "ecs.c6,ecs.g6"

    Menentukan atau mengecualikan keluarga instance ECS tertentu saat membuat pod dengan menentukan spesifikasi vCPU dan memori.

    Tentukan atau kecualikan generasi tertentu dari keluarga instance ECS untuk membuat pod

    k8s.aliyun.com/eci-instance-generation

    "6,5"

    Menentukan atau mengecualikan generasi tertentu dari keluarga instance ECS saat membuat pod dengan menentukan spesifikasi vCPU dan memori.

    Tentukan kategori komputasi untuk membuat pod

    k8s.aliyun.com/eci-compute-category

    Ekonomis

    Lebih lanjut menentukan kategori komputasi saat membuat pod dengan menentukan spesifikasi vCPU dan memori.

    • Nilai valid: ekonomis dan umum.

    • Anda dapat menentukan beberapa kategori komputasi. Sistem memilih kategori untuk pod berdasarkan urutan kategori yang ditentukan.

    Buat instance kontainer elastis preemptible

    k8s.aliyun.com/eci-spot-strategy

    SpotAsPriceGo

    Menentukan kebijakan penawaran untuk instance preemptible. Nilai valid:

    • SpotWithPriceLimit: Instance dibuat sebagai instance preemptible di mana Anda menentukan harga maksimum per jam. Jika Anda menggunakan kebijakan penawaran ini, Anda harus menentukan anotasi k8s.aliyun.com/eci-spot-price-limit.

    • SpotAsPriceGo: Instance dibuat sebagai instance preemptible di mana harga pasar saat pembelian digunakan sebagai harga penawaran secara otomatis.

    k8s.aliyun.com/eci-spot-price-limit

    "0.5"

    Menentukan harga maksimum per jam dari instance preemptible. Nilai ini dapat akurat hingga tiga tempat desimal.

    Anotasi ini hanya berlaku saat k8s.aliyun.com/eci-spot-strategy disetel ke SpotWithPriceLimit.

    k8s.aliyun.com/eci-spot-duration

    "0"

    Menentukan periode perlindungan instance preemptible. Satuan: jam. Nilai default: 1. Nilai 0 menunjukkan tidak ada periode perlindungan.

    k8s.aliyun.com/eci-spot-fallback

    "true"

    Menentukan apakah akan secara otomatis membuat instance bayar sesuai pemakaian jika sumber daya inventaris yang memenuhi persyaratan untuk spesifikasi instance preemptible tidak mencukupi. Nilai default: false.

    Gunakan kolam pribadi elastisitas assurance untuk membuat pod

    k8s.aliyun.com/eci-privatepool-matchcriteria

    "Open"

    Menentukan mode pencocokan di mana sistem mencocokkan kolam pribadi. Nilai valid:

    • Open: Sistem mencocokkan instance dengan kolam pribadi terbuka.

    • Target: Jika Anda menggunakan mode pencocokan ini, Anda harus menentukan ID kolam pribadi. Jika Anda menggunakan kolam pribadi bertarget untuk membuat pod, Anda harus menggunakan mode pencocokan ini.

    k8s.aliyun.com/eci-privatepool-id

    eap-2ze1g68k2melxkkl****

    Menentukan ID kolam pribadi (ID elastisitas assurance). Anda dapat memperoleh ID kolam pribadi pada tab Resource Reservations atau Private Pools halaman Reservasi Sumber Daya di konsol ECS.

    • Jika Anda menyetel k8s.aliyun.com/eci-privatepool-matchcriteria ke Target, Anda harus mengonfigurasi anotasi ini.

    • Jika Anda menyetel k8s.aliyun.com/eci-privatepool-matchcriteria ke Open, anotasi ini tidak valid.

    Konfigurasikan kebijakan penanganan kesalahan untuk pod

    k8s.aliyun.com/eci-fail-strategy

    fail-back

    Menentukan kebijakan penanganan kesalahan pod berbasis Elastic Container Instance. Nilai valid:

    • fail-back: Setelah pod gagal dibuat, sistem secara otomatis mencoba membuat ulang pod.

    • fail-over: Efek fail-over sama dengan efek fail-back.

    • fail-fast: Setelah pod gagal dibuat, sistem langsung melaporkan kesalahan.

    Tentukan durasi pending maksimum pod berbasis Elastic Container Instance

    k8s.aliyun.com/eci-max-pending-minute

    "30"

    Menentukan durasi pending maksimum pod. Sistem secara otomatis menghentikan pod setelah durasi pending maksimum berakhir.

    Nilai harus berupa bilangan bulat dari 10 hingga 1440. Satuan: menit. Nilai default: 240.

    Konfigurasikan host untuk pod berbasis Elastic Container Instance

    k8s.aliyun.com/eci-custom-hosts

    "[{\"host\":\"example.com\",\"ip\":\"100.100.XX.XX\"},{\"host\":\"aliyundoc.com\",\"ip\":\"100.100.XX.XX\"}]"

    Mengonfigurasi host (/etc/hosts) dari pod.

    Ikat tag kustom ke pod

    k8s.aliyun.com/eci-custom-tags

    "env:test,name:alice"

    Menentukan string tag. Anda dapat mengikat maksimal tiga tag. Pisahkan kunci tag dan nilai tag dengan titik dua (:). Pisahkan beberapa tag dengan koma (,).

    Tetapkan peran RAM ke pod

    k8s.aliyun.com/eci-ram-role-name

    AliyunECIContainerGroupRole

    Mengikat peran RAM yang dapat diasumsikan oleh pod untuk mengakses layanan Alibaba Cloud lainnya.

    Gambar

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Gunakan ImageCaches untuk mempercepat pembuatan pod

    k8s.aliyun.com/eci-auto-imc

    "true"

    Menentukan apakah akan secara otomatis mencocokkan cache gambar.

    k8s.aliyun.com/imc-perfect-match

    "true"

    Menentukan apakah semua gambar kontainer dalam pod harus cocok persis dengan cache gambar.

    k8s.aliyun.com/imc-match-count-request

    "2"

    Menentukan jumlah gambar kontainer dalam pod yang ingin Anda cocokkan persis dengan cache gambar.

    k8s.aliyun.com/eci-imc-id

    imc-2zebxkiifuyzzlhl****

    Menentukan ID cache gambar.

    Tarik gambar dari instance Container Registry tanpa menggunakan rahasia

    k8s.aliyun.com/acr-instance-ids

    cri-j36zhodptmyq****

    Menentukan ID instance Container Registry Enterprise Edition Alibaba Cloud. Anda dapat menarik gambar dari instance tersebut tanpa menggunakan rahasia.

    Anda dapat menentukan ID instance Container Registry Enterprise Edition yang berada di wilayah berbeda dari wilayah pod. Dalam kasus ini, Anda harus menambahkan ID wilayah instance Enterprise Edition ke ID instance Enterprise Edition. Contoh: "cn-beijing:cri-j36zhodptmyq****".

    k8s.aliyun.com/acr-service-arns

    acs:ram::1609982529******:role/role-assume

    Menentukan Nama Sumber Daya Alibaba Cloud (ARN) dari peran RAM di akun Alibaba Cloud tempat sumber daya Elastic Container Instance berada.

    Anotasi ini diperlukan saat Anda menggunakan peran RAM untuk membuat sumber daya.

    k8s.aliyun.com/acr-user-arns

    acs:ram::1298452580******:role/role-acr

    Menentukan ARN dari peran RAM di akun Alibaba Cloud tempat instance Container Registry berada.

    Anotasi ini diperlukan saat Anda menarik gambar dari instance Container Registry yang dimiliki oleh akun Alibaba Cloud berbeda dari akun Alibaba Cloud sumber daya Elastic Container Instance.

    Tarik gambar dari repositori gambar yang dikelola sendiri

    k8s.aliyun.com/plain-http-registry

    harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80

    Mengonfigurasi alamat repositori gambar yang dikelola sendiri. Saat Anda membuat pod menggunakan gambar dalam repositori gambar yang dikelola sendiri yang menggunakan protokol HTTP, Anda harus menambahkan anotasi ini ke instance. Dengan cara ini, Elastic Container Instance menarik gambar melalui protokol HTTP bukan protokol HTTPS default. Ini mencegah kegagalan tarik gambar yang disebabkan oleh protokol berbeda.

    k8s.aliyun.com/insecure-registry

    harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80

    Mengonfigurasi alamat repositori gambar yang dikelola sendiri. Saat Anda membuat pod menggunakan gambar dalam repositori gambar yang dikelola sendiri yang menggunakan sertifikat tanda tangan sendiri, Anda harus menambahkan anotasi ini ke instance untuk melewati otentikasi sertifikat. Ini mencegah kegagalan tarik gambar yang disebabkan oleh kegagalan otentikasi sertifikat.

    Cache Data

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Gunakan DataCache untuk membuat pod

    k8s.aliyun.com/eci-data-cache-bucket

    default

    Menentukan bucket yang digunakan untuk menyimpan DataCache. Anda harus mengonfigurasi anotasi ini saat menggunakan DataCaches untuk membuat pod.

    k8s.aliyun.com/eci-data-cache-pl

    PL1

    Menentukan tingkat kinerja disk yang dibuat berdasarkan DataCache. Secara default, PL1 Enhanced SSD (ESSD) digunakan.

    k8s.aliyun.com/eci-data-cache-provisionedIops

    "40000"

    Menentukan IOPS baca/tulis yang disediakan untuk disk ESSD AutoPL. Nilai 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 peningkatan 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 dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Tetapkan grup keamanan ke pod

    k8s.aliyun.com/eci-security-group

    sg-bp1dktddjsg5nktv****

    Menentukan ID grup keamanan. Persyaratan berikut harus dipenuhi:

    • Anda dapat menetapkan hingga lima grup keamanan.

    • Grup keamanan yang ditetapkan harus termasuk dalam virtual private cloud (VPC) yang sama.

    • Grup keamanan yang ditetapkan harus dari jenis yang sama.

    Asosiasikan EIP dengan instance kontainer elastis

    k8s.aliyun.com/eci-eip-instanceid

    eip-bp1q5n8cq4p7f6dzu****

    Menentukan ID alamat IP elastis (EIP).

    k8s.aliyun.com/eci-with-eip

    "true"

    Menentukan apakah akan secara otomatis membuat EIP saat Anda membuat instance kontainer elastis dan mengasosiasikan EIP dengan instance tersebut.

    k8s.aliyun.com/eip-bandwidth

    "5"

    Menentukan bandwidth maksimum EIP. Satuan: Mbit/s. Nilai default: 5.

    k8s.aliyun.com/eip-common-bandwidth-package-id

    cbwp-2zeukbj916scmj51m****

    Menentukan ID paket bandwidth EIP yang ada yang ingin Anda asosiasikan dengan instance. Untuk informasi lebih lanjut, lihat Apa itu Bandwidth Internet Bersama?

    k8s.aliyun.com/eip-isp

    BGP

    Menentukan jenis jalur untuk EIP. Anotasi ini hanya berlaku untuk EIP bayar sesuai pemakaian. Nilai valid:

    • BGP: Jalur BGP (Multi-ISP)

    • BGP_PRO: Jalur BGP (Multi-ISP) Pro

    Untuk informasi lebih lanjut, lihat bagian "Jenis jalur" dari topik Apa itu EIP.

    k8s.aliyun.com/eip-internet-charge-type

    PayByBandwidth

    Menentukan metode pengukuran EIP. Nilai valid:

    • PayByBandwidth: bayar berdasarkan bandwidth

    • PayByTraffic: bayar berdasarkan trafik

    Untuk informasi lebih lanjut tentang penagihan EIP, lihat Ikhtisar Penagihan.

    k8s.aliyun.com/eip-public-ip-address-pool-id

    pippool-bp187arfugi543y1s****

    Menentukan ID kolam alamat IP. EIP dialokasikan dari kolam alamat IP. Untuk informasi lebih lanjut, lihat Buat dan kelola kolam alamat IP.

    Tetapkan alamat IPv6 ke pod berbasis Elastic Container Instance

    k8s.aliyun.com/eci-enable-ipv6

    "true"

    Menentukan apakah akan menetapkan alamat IPv6 ke pod.

    k8s.aliyun.com/eci-ipv6-bandwidth-enable

    "true"

    Menentukan apakah akan mengaktifkan akses Internet melalui alamat IPv6 untuk instance.

    k8s.aliyun.com/eci-ipv6-bandwidth

    100M

    Menentukan bandwidth publik puncak alamat IPv6.

    Tentukan alamat IP privat untuk pod

    k8s.aliyun.com/eci-private-ip-address

    "172.16.0.1"

    Menentukan alamat IP privat pod. Hanya alamat IPv4 yang didukung. Pastikan bahwa alamat IP tersebut tidak digunakan.

    Konfigurasikan pod berbasis Elastic Container Instance untuk menggunakan alamat IP tetap

    k8s.aliyun.com/eci-fixed-ip

    "true"

    Menentukan apakah akan mengonfigurasi pod untuk menggunakan alamat IP tetap.

    k8s.aliyun.com/eci-fixed-ip-retain-hour

    "24"

    Menentukan periode retensi alamat IP tetap setelah pod dengan alamat IP tetap diaktifkan dilepaskan dan alamat IP tetap menjadi idle. Satuan: jam.

    Jika Anda tidak mengonfigurasi anotasi, alamat IP tetap dipertahankan selama 48 jam secara default.

    Batasi bandwidth masuk dan keluar pod

    kubernetes.io/ingress-bandwidth

    40M

    Menentukan bandwidth masuk.

    kubernetes.io/egress-bandwidth

    20M

    Menentukan bandwidth keluar.

    Konfigurasikan server DNS kustom untuk pod

    k8s.aliyun.com/eci-custom-dnsconfig

    {\"nameservers\":\"20.1.xx.xx,20.1.xx.xx\",\"searches\":\"xx.com,xx.eee\",\"options\":\"ndots:2,edns0\"}

    Dalam skenario cloud hybrid, tentukan server Domain Name System (DNS) untuk pod dan gunakan server DNS untuk menyelesaikan nama domain internal.

    Penyimpanan

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Tingkatkan kapasitas ruang penyimpanan sementara

    k8s.aliyun.com/eci-extra-ephemeral-storage

    50Gi

    Menentukan ukuran ruang penyimpanan sementara.

    Enkripsi ruang penyimpanan sementara

    k8s.aliyun.com/eci-ephemeral-storage-options

    "{\"encrypted\":\"true\"}"

    Menentukan parameter untuk ruang penyimpanan sementara. Nilai "{\"encrypted\":\"true\"}" menunjukkan bahwa fitur enkripsi diaktifkan untuk ruang penyimpanan sementara.

    Konfigurasi Kontainer

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Konfigurasikan layanan NTP untuk pod

    k8s.aliyun.com/eci-ntp-server

    100.100.*.*

    Menentukan alamat IP server Network Time Protocol (NTP).

    Log

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Kumpulkan log menggunakan CRD Layanan Log Sederhana

    k8s.aliyun.com/eci-sls-enable

    "false"

    Menentukan apakah akan mengaktifkan fitur pengumpulan log.

    Jika Anda tidak ingin mengumpulkan log untuk pod tertentu saat menggunakan CRD Layanan Log Sederhana (custom resource definitions) untuk mengumpulkan log, Anda dapat menyetel anotasi ke false untuk menonaktifkan fitur pengumpulan log. Ini mencegah pemborosan sumber daya saat sistem secara otomatis membuat Logtail.

    O&M

    Fitur dan dokumen terkait

    Anotasi

    Contoh

    Deskripsi

    Lihat file core dump

    k8s.aliyun.com/eci-core-pattern

    /pod/data/dump/core

    Menentukan direktori tempat file core dump disimpan.

    Anotasi yang Dapat Ditambahkan SetelahSistem Mengalokasikan Sumber Daya dan Membuat Pod

    Tabel berikut menjelaskan anotasi yang dapat ditambahkan setelah sistem mengalokasikan sumber daya dan membuat pod. Anda dapat menjalankan perintah kubectl describe untuk menanyakan detail pod.

    Anotasi

    Contoh

    Deskripsi

    k8s.aliyun.com/eci-request-id

    45942504-4688-51BA-BBAB-4B692C4F39C0

    Menunjukkan ID permintaan.

    k8s.aliyun.com/eci-instance-id

    eci-2ze1y0la40qgva09****

    Menunjukkan ID pod.

    k8s.aliyun.com/eci-instance-spec

    2.0-4.0 Gi

    Menunjukkan spesifikasi pod. Anda akan dikenakan biaya berdasarkan nilai tersebut.

    • Jika nilai yang dikembalikan, seperti 2.0-4.0Gi, menunjukkan jumlah vCPU dan ukuran memori, Anda akan dikenakan biaya berdasarkan jumlah vCPU dan ukuran memori.

    • Jika nilai yang dikembalikan adalah tipe Instance ECS, seperti ecs.c6.large, Anda akan dikenakan biaya berdasarkan tipe Instance ECS.

    k8s.aliyun.com/eci-instance-compute-category

    ekonomis

    Menunjukkan kategori komputasi dari tipe instance ECS berdasarkan pod dibuat.

    • Jika nilainya ekonomis, Anda akan dikenakan biaya berdasarkan pod kategori komputasi ekonomis.

    • Jika nilainya umum, Anda akan dikenakan biaya berdasarkan pod kategori komputasi umum.

    k8s.aliyun.com/allocated-eipInstanceId

    eip-bp1q5n8cq4p7f6dzu****

    Menunjukkan ID EIP.

    k8s.aliyun.com/allocated-eipAddress

    47.99.**.**

    Menunjukkan EIP yang terkait dengan instance.

    k8s.aliyun.com/allocated-ipv6Address

    2001:d**:1:1:1:1:1:1

    Menunjukkan alamat IPv6 yang dialokasikan ke pod.

    k8s.aliyun.com/eci-created-by-template

    true

    Menunjukkan apakah template digunakan untuk membuat pod.

    k8s.aliyun.com/eni-instance-id

    eni-2ze6d7oo5ukqj26o****

    Menunjukkan ID antarmuka jaringan elastis (ENI) yang terikat ke pod.

    k8s.aliyun.com/eci-vpc

    vpc-2zeghwzptn5zii0w7****

    Menunjukkan virtual private cloud (VPC) tempat pod berada.

    k8s.aliyun.com/eci-matched-image-cache

    imc-2zedy3v37800iimu****

    Menunjukkan ID cache gambar yang cocok.

    k8s.aliyun.com/eci-schedule-result

    finished

    Menunjukkan hasil penjadwalan. Anotasi ini sudah tidak digunakan lagi. Untuk informasi tentang hasil penjadwalan pod, lihat ContainerInstanceCreated.