Referensi anotasi Pod - Container Compute Service - Alibaba Cloud Documentation Center

Tambahkan anotasi ke pod Container Compute Service (ACS) untuk mengonfigurasi jaringan, perilaku pengambilan image, penjadwalan, dan pengaturan sistem operasi. Referensi ini mencantumkan semua anotasi yang didukung, dikelompokkan berdasarkan kategori.

Anotasi untuk konfigurasi pod

Tetapkan anotasi-anotasi ini di metadata.annotations saat membuat pod atau Deployment.

Contoh konfigurasi Pod

apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    # Tentukan satu atau beberapa ID vSwitch untuk mengontrol zona tempat pod dibuat
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
    # Sambungkan EIP secara otomatis saat pod dimulai
    network.alibabacloud.com/pod-with-eip: "true"
spec:
  ...

Contoh konfigurasi Deployment

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

Jaringan

Parameter	Contoh	Deskripsi
`network.alibabacloud.com/vswitch-ids`	`"vsw-slw1,vsw-lkjwo"`	ID vSwitch untuk pod. Tentukan beberapa ID untuk membuat pod di beberapa zona. Lihat Tentukan vSwitch dan security group untuk pod. Penting Jika vSwitch dan affinity keduanya ditetapkan, ACS akan menggunakan vSwitch yang ditentukan dan mengabaikan konfigurasi affinity. Jika pod menggunakan PersistentVolumeClaim (PVC) dengan mode binding `WaitForFirstConsumer`, tentukan juga zona target dalam pengaturan affinity pod agar penjadwal dapat mencocokkan zona PVC dengan vSwitch dan mencegah pod tetap dalam status Pending. Lihat Penjadwalan afinitas node.
`network.alibabacloud.com/security-group-ids`	`"sg-sljwo,sg-lwirp"`	ID security group untuk pod. Tentukan beberapa ID untuk menyambungkan beberapa security group.
`network.alibabacloud.com/custom-dnsconfig`	`{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}`	Konfigurasi DNS kustom untuk pod. Lihat Konfigurasi DNS kustom menggunakan anotasi.
`alibabacloud.com/enable-network-policy-agent`	`"true"`	Mengaktifkan NetworkPolicy untuk pod. Nilai default: `false`. Lihat Gunakan kebijakan jaringan di kluster ACS.

Konfigurasi EIP

Gunakan anotasi berikut untuk menyambungkan alamat IP elastis (EIP) ke pod. Lihat Sambungkan EIP ke pod menggunakan anotasi.

Parameter	Contoh	Deskripsi
`network.alibabacloud.com/pod-with-eip`	`"true"`	Menentukan apakah akan membuat dan menyambungkan EIP secara otomatis ke pod. Nilai yang valid: `true` atau `false`.
`network.alibabacloud.com/pod-eip-instanceid`	`"eip-bp14q***"`	Menggunakan EIP yang sudah ada. Masukkan ID instans EIP. Lihat Ajukan EIP.
`network.alibabacloud.com/eip-bandwidth`	`"5"`	Bandwidth maksimum EIP, dalam satuan Mbit/s.
`network.alibabacloud.com/eip-internet-charge-type`	`"PayByTraffic"`	Metode penagihan transfer data EIP. Nilai yang valid: `PayByTraffic` (default) \| `PayByBandwidth`. Lihat Metode penagihan EIP.
`network.alibabacloud.com/eip-instance-charge-type`	`"PrePaid"`	Metode penagihan instans EIP. Nilai yang valid: `PrePaid` (subscription) \| `PostPaid` (pay-as-you-go). Lihat Subscription dan Pay-as-you-go.
`network.alibabacloud.com/eip-common-bandwidth-package-id`	`"cbwp-slex***"`	Menyambungkan EIP pod ke 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). Lihat Ajukan EIP.
`network.alibabacloud.com/eip-public-ip-address-pool-id`	`"pippool-dlsw***"`	Kolam alamat EIP tempat EIP dialokasikan. Lihat Kolam alamat IP.
`network.alibabacloud.com/eip-resource-group-id`	N/A	Grup resource untuk EIP. Lihat Ajukan EIP.
`network.alibabacloud.com/eip-name`	N/A	Nama EIP.
`network.alibabacloud.com/eip-description`	N/A	Deskripsi EIP.
`network.alibabacloud.com/eip-security-protection-types`	N/A	Layanan keamanan yang diterapkan pada EIP. Pisahkan beberapa nilai dengan koma (`,`). Lihat Ajukan EIP.
`network.alibabacloud.com/pod-eip-release-strategy`	`"Never"`	Kebijakan pelepasan EIP pod saat pod dihapus. Nilai yang valid: `Follow`: default — EIP dilepas saat pod dihapus. `Never`: EIP dipertahankan; hapus secara manual jika tidak lagi diperlukan. Durasi gaya Go: misalnya, `5m30s` menghapus EIP 5 menit 30 detik setelah pod dihapus.

Image

Parameter	Contoh	Deskripsi
`registry.alibabacloud.com/plain-http-registry`	`"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80"`	Registri yang menggunakan HTTP biasa. Konfigurasikan ini untuk mencegah kegagalan pengambilan saat repository image menggunakan HTTP alih-alih HTTPS. Pisahkan beberapa entri dengan koma. Lihat Gunakan repository image yang dikelola sendiri.
`registry.alibabacloud.com/insecure-registry`	`"harbor.pre.com,192.168.XX.XX:5000,reg.test.com:80"`	Registri dengan sertifikat tanda tangan sendiri. Konfigurasikan ini untuk melewati validasi sertifikat dan mencegah kegagalan pengambilan. Pisahkan beberapa entri dengan koma.

Penjadwalan

Fitur	Parameter	Contoh	Deskripsi
Kebijakan penjadwalan multi-zona pod	scheduling.alibabacloud.com/schedule-strategy	"VSwitchOrdered"	Kebijakan penjadwalan multi-zona. Nilai yang valid: `VSwitchOrdered`: Menjadwalkan pod di beberapa vSwitch sesuai urutan yang tercantum. `VSwitchRandom`: Menjadwalkan pod di beberapa vSwitch secara acak.
Kebijakan penanganan kegagalan pod	scheduling.alibabacloud.com/fail-strategy	"fail-back"	Kebijakan penanganan kegagalan untuk pod. Nilai yang valid: `fail-back`: Memulihkan secara otomatis dari kegagalan. Jika pembuatan pod gagal, sistem akan mencoba membuatnya lagi secara otomatis. `fail-over`: Memindahkan pod saat terjadi kegagalan. Efeknya sama dengan `fail-back`. `fail-fast`: Jika pembuatan pod gagal, kesalahan dilaporkan segera.
Durasi maksimum pod dalam status pending	scheduling.alibabacloud.com/max-pending-minute	"10"	Durasi maksimum pod dapat tetap dalam status pending. Jika periode timeout terlampaui, sistem secara otomatis menghentikan instans tersebut. Nilainya harus berupa bilangan bulat dalam rentang `10-1440`. Satuannya adalah menit. Durasi minimum adalah 10 menit, dan maksimum adalah 1 hari. Nilai default adalah 4 jam. Penghitungan mundur dimulai saat pembuatan sandbox dimulai. Pod yang belum mencapai tahap pembuatan sandbox tidak terpengaruh oleh timeout ini.

Sistem operasi

Parameter

Nilai contoh

Deskripsi

alibabacloud.com/os-kernel-config

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

Pengaturan Transparent Huge Pages untuk OS pod. Kelas komputasi yang didukung: GPU dan GPU-HPN. Subparameter:

transparentHugepageEnabled: memetakan ke /sys/kernel/mm/transparent_hugepage/enabled; nilai yang valid:
- always
- madvise
- never
transparentHugepageShmemEnabled: memetakan ke /sys/kernel/mm/transparent_hugepage/shmem_enabled; nilai yang valid:
- always
- within_size
- advise
- never
- deny
- force

Anotasi yang ditambahkan oleh ACS

Catatan

ACS menulis anotasi-anotasi ini ke pod setelah pod dibuat. Anotasi ini mencerminkan hasil alokasi waktu proses, termasuk penugasan elastic network interface (ENI) dan EIP. Anotasi ini tidak dapat ditetapkan atau dimodifikasi.

Alokasi ENI

Parameter	Nilai contoh	Deskripsi
`network.alibabacloud.com/allocated-eni-id`	`"eni-esdxs***"`	ID ENI yang dialokasikan.
`network.alibabacloud.com/vpc-id`	`"vpc-sljwo***"`	ID VPC tempat ENI berada.
`network.alibabacloud.com/vswitch-id`	`"vsw-lskdw***"`	ID vSwitch tempat ENI ditugaskan. Jika Anda menentukan beberapa vSwitch, kolom ini menampilkan vSwitch yang benar-benar digunakan.

Alokasi EIP

Parameter	Nilai contoh	Deskripsi
`network.alibabacloud.com/allocated-eip-id`	`"eip-bp1m***"`	ID EIP yang dialokasikan.
`network.alibabacloud.com/allocated-eip-address`	`"116.62.***"`	Alamat IP EIP yang dialokasikan.

Spesifikasi resource

Parameter	Nilai contoh	Deskripsi
`alibabacloud.com/pod-use-spec`	`"2.5-5Gi"`	Spesifikasi CPU dan memori yang dinormalisasi. Formatnya adalah `{xxvCPU}-{xxGiB}`.
`alibabacloud.com/pod-gpu-use-spec`	`"1"`	Jumlah kartu GPU yang dinormalisasi.
`alibabacloud.com/pod-ephemeral-storage`	`"30Gi"`	Ukuran penyimpanan sementara yang dinormalisasi, dalam satuan GiB.

Hasil penjadwalan

Parameter	Nilai contoh	Deskripsi
`topology.kubernetes.io/region`	`"cn-hangzhou"`	Wilayah tempat pod berjalan.
`topology.kubernetes.io/zone`	`"cn-hangzhou-i"`	Zona tempat pod berjalan.

Metadata lainnya

Parameter	Nilai contoh	Deskripsi
`alibabacloud.com/instance-id`	`"acs-sdsf***"`	ID instans pod ACS.
`alibabacloud.com/request-id`	`"6925D4B7-***"`	ID permintaan dari permintaan API pembuatan pod.

Kompatibilitas anotasi lama

Anotasi berikut didukung demi kompatibilitas versi sebelumnya. Untuk penerapan baru, gunakan anotasi pengganti yang direkomendasikan di bawah ini.

Anotasi lama	Pengganti yang direkomendasikan
`k8s.aliyun.com/eci-eip-instanceid`	`network.alibabacloud.com/pod-eip-instanceid`
`k8s.aliyun.com/eip-charge-type`	`network.alibabacloud.com/eip-internet-charge-type`