Referensi anotasi Pod - Container Compute Service

Anda dapat menggunakan anotasi untuk mengaktifkan dan mengonfigurasi fitur tambahan pada pod ACS. Topik ini menjelaskan anotasi pod yang didukung oleh ACS.

Anotasi yang dapat ditambahkan saat membuat pod ACS

Anda dapat menambahkan anotasi ke pod untuk mengaktifkan fitur tertentu dan menerapkan konfigurasi. Kode berikut memberikan contohnya.

Contoh konfigurasi Pod

apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
spec:
  ...

Contoh konfigurasi Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
  name: foo
  ...
spec:
  ...
  template:
    metadata:
      annotations:
        network.alibabacloud.com/vswitch-ids: "vsw-foo"
    ...

Network

Fitur	Parameter	Nilai contoh	Deskripsi
Tentukan vSwitch dan security group untuk pod	network.alibabacloud.com/vswitch-ids	"vsw-slw1*,vsw-lkjwo*"	Menentukan ID vSwitch. Anda dapat menentukan beberapa ID vSwitch untuk membuat pod di beberapa zona. Penting Jika pod menentukan vSwitch dan affinity secara bersamaan, ACS akan memprioritaskan vSwitch yang ditentukan saat membuat resource. Konfigurasi affinity akan diabaikan. Penting Jika pod juga menggunakan PersistentVolumeClaim (PVC) tipe WaitForFirstConsumer, tentukan zona yang sesuai dalam pengaturan affinity pod. Penjadwal memastikan bahwa zona yang dialokasikan untuk PVC cocok dengan vSwitch agar pod tidak menjadi pending. Untuk informasi selengkapnya, lihat Penjadwalan afinitas node.
Tentukan vSwitch dan security group untuk pod	network.alibabacloud.com/security-group-ids	"sg-sljwo*,sg-lwirp*"	Menentukan ID security group. Anda dapat menentukan beberapa ID security group.
Konfigurasi DNS kustom menggunakan anotasi	network.alibabacloud.com/custom-dnsconfig	{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}	Menentukan konfigurasi DNS kustom.
Gunakan kebijakan jaringan dalam klaster ACS	alibabacloud.com/enable-network-policy-agent	"true"	Mengaktifkan NetworkPolicy untuk pod ACS. Nilai default adalah `false`.
Sambungkan EIP ke pod menggunakan anotasi	network.alibabacloud.com/pod-with-eip	"true"	Menentukan apakah akan secara otomatis membuat dan menyambungkan EIP. Nilai yang valid: `true`: Secara otomatis membuat dan menyambungkan EIP. `false`: Tidak secara otomatis membuat dan menyambungkan EIP.
	network.alibabacloud.com/pod-eip-instanceid	"eip-bp14q***"	Menggunakan EIP yang ditentukan. Masukkan ID instans EIP, seperti eip-bp14q***. Untuk informasi selengkapnya, lihat Ajukan EIP.
	k8s.aliyun.com/eci-eip-instanceid (kompatibel dengan anotasi ECI)	"eip-bp14q***"
	network.alibabacloud.com/eip-bandwidth	"5"	Bandwidth puncak EIP. Satuan: Mbit/s.
	network.alibabacloud.com/eip-internet-charge-type	"PayByTraffic"	Metode pengukuran untuk EIP. Nilai yang valid: `PayByTraffic`: Nilai default. pay-by-traffic. `PayByBandwidth`: pay-by-bandwidth. Untuk informasi selengkapnya, lihat Metode penagihan EIP.
	k8s.aliyun.com/eip-charge-type (kompatibel dengan anotasi versi sebelumnya)	"PayByTraffic"
	network.alibabacloud.com/eip-instance-charge-type	"PrePaid"	Metode penagihan instans EIP. Nilai yang valid: `PrePaid`: subscription. `PostPaid`: pay-as-you-go. Untuk informasi lebih lanjut, lihat Langganan dan Bayar sesuai pemakaian.
	network.alibabacloud.com/eip-common-bandwidth-package-id	"cbwp-slex***"	Menyambungkan instans Internet Shared Bandwidth yang sudah ada.
	network.alibabacloud.com/eip-isp	"BGP"	Jenis jalur EIP. Nilai yang valid: `BGP`: BGP (Multi-ISP). `BGP_PRO`: BGP (Multi-ISP) Pro. Untuk informasi selengkapnya, lihat Ajukan EIP.
	network.alibabacloud.com/eip-public-ip-address-pool-id	"pippool-dlsw***"	Kolam alamat EIP. Untuk informasi tentang batasan dan langkah-langkah penggunaan kolam alamat EIP, lihat Kolam alamat IP.
	network.alibabacloud.com/eip-resource-group-id		Kelompok sumber daya EIP. Untuk informasi selengkapnya, lihat Ajukan EIP.
	network.alibabacloud.com/eip-name		Nama EIP. Untuk informasi selengkapnya, lihat Ajukan EIP.
	network.alibabacloud.com/eip-description		Deskripsi EIP. Untuk informasi selengkapnya, lihat Ajukan EIP.
	network.alibabacloud.com/eip-security-protection-types		Layanan keamanan yang digunakan untuk melindungi EIP. Pisahkan beberapa layanan keamanan dengan koma `,`. Untuk informasi selengkapnya, lihat Ajukan EIP.
	network.alibabacloud.com/pod-eip-release-strategy	"Never"	Kebijakan rilis EIP pod. Nilai yang valid: `Follow`: Nilai default. EIP mengikuti siklus hidup pod. `Never`: EIP pod tidak dihapus. Anda harus menghapus EIP secara manual ketika tidak lagi diperlukan. Konfigurasikan waktu kedaluwarsa. Misalnya, `5m30s` berarti EIP dihapus 5 menit 30 detik setelah pod dihapus. Ekspresi durasi waktu bergaya Go didukung.

Image

Fitur	Parameter	Nilai contoh	Deskripsi
Gunakan repository image yang dikelola sendiri	registry.alibabacloud.com/plain-http-registry	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"	Saat menarik citra dari repository image yang dikelola sendiri yang menggunakan protokol HTTP, konfigurasikan parameter ini untuk mencegah kegagalan penarikan citra akibat perbedaan protokol.
Gunakan repository image yang dikelola sendiri	registry.alibabacloud.com/insecure-registry	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"	Saat menarik citra dari repository image yang dikelola sendiri yang menggunakan sertifikat tanda tangan sendiri, konfigurasikan parameter ini untuk melewati autentikasi sertifikat. Hal ini mencegah kegagalan penarikan citra akibat kegagalan autentikasi sertifikat.

Scheduling

Fitur	Parameter	Nilai contoh	Deskripsi
Kebijakan retry kualitas daya komputasi pod	alpha.alibabacloud.com/compute-qos-strategy	"best-effort-to-default"	Menentukan kebijakan retry compute-qos. Nilai yang valid adalah `best-effort-to-default`: Kualitas daya komputasi BestEffort digunakan terlebih dahulu. Jika sumber daya tidak mencukupi, kualitas daya komputasi Default digunakan. Penting Anda tidak perlu menentukan label `alibabacloud.com/compute-qos` saat menggunakan anotasi ini. Jika label tersebut sudah ada, nilai label tersebut akan diutamakan.

Operating system

Fitur

Parameter

Nilai contoh

Deskripsi

Ubah Transparent Huge Pages untuk sistem operasi pod

Hanya kelas komputasi GPU dan GPU-HPN yang didukung.

alibabacloud.com/os-kernel-config

{"transparentHugepageEnabled": "madvise","transparentHugepageShmemEnabled": "advise"}

transparentHugepageEnabled: Sesuai dengan file konfigurasi kernel /sys/kernel/mm/transparent_hugepage/enabled. Nilai yang valid:
- always
- madvise
- never
transparentHugepageShmemEnabled: Sesuai dengan file konfigurasi kernel /sys/kernel/mm/transparent_hugepage/shmem_enabled. Nilai yang valid:
- always
- within_size
- advise
- never
- deny
- force

Anotasi yang secara otomatis ditambahkan oleh ACS

Catatan

Anotasi berikut berisi informasi yang dihasilkan oleh ACS, seperti hasil alokasi elastic network interfaces (ENIs) dan EIP. Anda tidak dapat mengatur atau mengubah anotasi ini.

Fitur	Parameter	Nilai contoh	Deskripsi
Informasi alokasi ENI	network.alibabacloud.com/allocated-eni-id	"eni-esdxs***"	ID elastic network interface (ENI) yang dialokasikan.
	network.alibabacloud.com/vpc-id	"vpc-sljwo***"	ID VPC tempat ENI tersebut berada.
	network.alibabacloud.com/vswitch-id	"vsw-lskdw***"	ID vSwitch tempat ENI tersebut berada. Jika Anda menentukan beberapa vSwitch saat membuat pod ACS, vSwitch yang akhirnya digunakan akan ditampilkan di sini.
Informasi alokasi EIP	network.alibabacloud.com/allocated-eip-id	"eip-bp1m***"	ID EIP yang dialokasikan.
Informasi alokasi EIP	network.alibabacloud.com/allocated-eip-address	"116.62.***"	Alamat IP EIP yang dialokasikan.
Spesifikasi sumber daya	alibabacloud.com/pod-use-spec	"2.5-5Gi"	Spesifikasi CPU dan memori pod ACS setelah normalisasi. Formatnya adalah "xxvCPU-xxGiB".
	alibabacloud.com/pod-gpu-use-spec	"1"	Jumlah kartu GPU pada pod ACS setelah normalisasi.
	alibabacloud.com/pod-ephemeral-storage	"30Gi"	Ukuran ruang penyimpanan sementara pod ACS setelah normalisasi, dalam satuan GiB.
Informasi hasil penjadwalan	topology.kubernetes.io/region	"cn-hangzhou"	Wilayah tempat pod ACS berada.
Informasi hasil penjadwalan	topology.kubernetes.io/zone	"cn-hangzhou-i"	Zona tempat pod ACS berada.
Metadata lainnya	alibabacloud.com/instance-id	"acs-sdsf***"	ID instans pod ACS.
Metadata lainnya	alibabacloud.com/request-id	"6925D4B7-***"	ID permintaan.