Saat menjalankan kluster ACK Pro di lingkungan produksi, Anda mungkin perlu menyesuaikan perilaku lapisan kontrol untuk memenuhi kebutuhan performa, keamanan, atau kepatuhan. ACK Pro memungkinkan Anda mengubah parameter komponen inti lapisan kontrol—kube-apiserver, kube-controller-manager, cloud-controller-manager (CCM), dan kube-scheduler—langsung melalui Konsol.
Topik ini menjelaskan cara menyesuaikan parameter tersebut dan mencantumkan parameter yang tersedia untuk setiap jenis kluster.
Sebelum memulai
Pastikan Anda telah memiliki:
Kluster ACK yang dikelola Edisi Pro, Kluster ACK Serverless Edisi Pro, Kluster ACK Edge Edisi Pro, atau Kluster ACK LINGJUN
Izin yang diperlukan untuk mengubah add-on kluster di Container Service Management Console
Catatan penggunaan
Restart lapisan kontrol: Lapisan kontrol akan restart setelah Anda menyimpan perubahan parameter. Lakukan operasi ini pada jam sepi untuk meminimalkan dampak.
Parameter menggantikan nilai default: Parameter kustom sepenuhnya menggantikan parameter default kluster. Pastikan konfigurasi Anda lengkap dan benar sebelum menyimpan. Parameter yang salah atau tidak lengkap dapat mencegah lapisan kontrol berjalan.
Batasan versi: Beberapa parameter hanya tersedia pada versi kluster tertentu. Persyaratan versi dicantumkan di setiap tabel parameter. Untuk melakukan upgrade kluster, lihat Upgrade kluster secara manual.
Konsol sebagai sumber kebenaran: Konsol menampilkan daftar terkini parameter yang dapat dikustomisasi. Tabel dalam topik ini mencerminkan nilai default yang didokumentasikan.
Menyesuaikan parameter komponen lapisan kontrol
Langkah-langkahnya sama untuk semua komponen lapisan kontrol. Contoh berikut menggunakan kube-apiserver.
Login ke Container Service Management Console. Di panel navigasi kiri, klik Clusters.
Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Add-ons.
Di bagian Core Components, temukan komponen yang ingin Anda konfigurasikan, lalu klik Configuration di pojok kanan bawah kartunya.
Di kotak dialog Parameters, masukkan parameter kustom Anda. Pastikan konfigurasi lengkap dan benar, lalu ikuti petunjuk di layar untuk mengirimkan.
Parameter default
Tabel berikut mencantumkan parameter yang dapat dikustomisasi untuk setiap jenis kluster. Untuk semantik parameter dan nilai valid di luar yang tercantum, rujuk dokumentasi resmi Kubernetes: kube-apiserver, kube-controller-manager, dan kube-scheduler.
Kluster ACK yang dikelola Edisi Pro
kube-apiserver
| Parameter | Description | Valid range / notes |
|---|---|---|
enableAdmissionPlugins | Mengaktifkan plugin admission controller tambahan. | Default: blank. |
serviceNodePortRange | Rentang port untuk layanan NodePort. | 10000–65535. Default: blank. Penting Pastikan rentang ini tidak tumpang tindih dengan |
requestTimeout | Timeout global untuk permintaan API yang tidak memiliki timeout spesifik. | Default: blank (menggunakan nilai default Kubernetes). |
defaultNotReadyTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status NotReady sebelum dievakuasi. | Default: blank. |
defaultUnreachableTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status Unreachable sebelum dievakuasi. | Default: blank. |
maxMutatingRequestsInflight | Jumlah maksimum permintaan API mutating bersamaan. Permintaan yang melebihi batas ini akan ditolak. | 1–1000. Default: blank. |
maxRequestsInflight | Jumlah maksimum permintaan API non-mutating bersamaan. | 1–3000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate Kubernetes tertentu. | Nilai yang didukung: ServerSideApply, TTLAfterFinished, EphemeralContainers, RemoveSelfLink, HPAScaleToZero. Default: blank. Catatan
|
oidcIssuerURL | URL penerbit OpenID Connect (OIDC) untuk integrasi penyedia identitas eksternal. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. Penting Setelah mengatur parameter ini, kube-apiserver mengakses alamat yang ditentukan. Jika merupakan Titik akhir publik, aktifkan akses jaringan publik untuk kluster. Jika server API tetap tidak dapat menjangkau titik akhir setelah mengaktifkan akses publik, jalankan |
oidcClientId | Client ID untuk penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernameClaim | Klaim JWT yang digunakan sebagai username untuk otentikasi OIDC. | Default: sub. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernamePrefix | Awalan yang ditambahkan ke username OIDC untuk menghindari konflik dengan nama yang sudah ada. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsPrefix | Awalan yang ditambahkan ke nama grup OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsClaim | Klaim JWT yang digunakan untuk mengisi grup pengguna dalam otentikasi OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcRequiredClaim | Pasangan kunci-nilai yang harus ada dalam Token ID OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcCAContent | Konten Otoritas Sertifikat (CA) dalam format PEM untuk memverifikasi penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
hostAliases | Pemetaan hostname-ke-IP kustom yang ditambahkan ke /etc/hosts Pod kube-apiserver. | Default: blank. Memerlukan versi kluster 1.26 atau lebih baru. |
enableTrace | Mengaktifkan pelacakan terdistribusi untuk komponen lapisan kontrol. | Default: blank. Memerlukan versi kluster 1.28 atau lebih baru. Lihat Aktifkan Analisis Tracing untuk komponen lapisan kontrol kluster. |
samplingRatePerMillion | Default: blank. |
kube-controller-manager
| Parameter | Description | Valid range / notes |
|---|---|---|
horizontalPodAutoscalerSyncPeriod | Frekuensi Penyekala Pod Horizontal (HPA) menghitung ulang jumlah replika yang diinginkan. | Default: blank (menggunakan nilai default Kubernetes). |
horizontalPodAutoscalerTolerance | Perubahan rasio minimum yang diperlukan sebelum HPA memicu aksi penskalaan. Mencegah thrashing. | Default: blank. |
concurrentTTLAfterFinishedSyncs | Jumlah pekerja konkuren yang membersihkan Pekerjaan selesai yang telah kedaluwarsa TTL-nya. | Default: blank. |
concurrentHorizontalPodAutoscalerSyncs | Jumlah pekerja sinkronisasi HPA konkuren. | Default: blank. Memerlukan versi kluster 1.26 atau lebih baru. |
largeClusterSizeThreshold | Ambang batas jumlah node di atas mana kluster dianggap "besar" untuk perhitungan evakuasi. | Default: blank. |
unhealthyZoneThreshold | Proporsi node dalam suatu zona yang harus tidak sehat untuk memicu penurunan laju evakuasi. | Default: blank. |
secondaryNodeEvictionRate | Laju evakuasi node saat kluster berada dalam mode evakuasi sekunder (tereduksi). | Default: blank. |
nodeEvictionRate | Laju eviksi node dalam kondisi normal. | Default: blank. |
terminatedPodGCThreshold | Jumlah Pod yang telah dihentikan yang memicu Pengumpulan sampah. | Default: blank. |
kubeAPIQPS | Maksimum permintaan per detik (QPS) dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
kubeAPIBurst | Maksimum lonjakan permintaan dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
concurrentCSRSyncs | Jumlah pekerja konkuren yang memproses objek CertificateSigningRequest (CSR). | Default: blank. Memerlukan versi kluster 1.32 atau lebih baru. |
concurrentNodeTaintSyncs | Jumlah pekerja konkuren yang menyinkronkan kondisi taint node. | Default: blank. Memerlukan versi kluster 1.32 atau lebih baru. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate tertentu untuk manajer kontroler. | Nilai yang didukung: TTLAfterFinished. Default: blank. |
cloud-controller-manager (CCM)
| Parameter | Description | Valid range / notes |
|---|---|---|
routeTableIDs | Daftar ID tabel rute VPC yang dipisahkan koma untuk dikelola oleh CCM. | Default: blank. Atur ini jika VPC Anda memiliki beberapa tabel rute. Contoh: vtb-,vtb*. |
kube-scheduler
Untuk parameter kube-scheduler, lihat Sesuaikan parameter penjadwal.
Kluster ACK serverless Edisi Pro
kube-apiserver
| Parameter | Description | Valid range / notes |
|---|---|---|
enableAdmissionPlugins | Mengaktifkan plugin admission controller tambahan. | Default: blank. |
requestTimeout | Timeout global untuk permintaan API yang tidak memiliki timeout spesifik. | Default: blank (menggunakan nilai default Kubernetes). |
defaultNotReadyTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status NotReady sebelum dievakuasi. | Default: blank. |
defaultUnreachableTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status Unreachable sebelum dievakuasi. | Default: blank. |
maxMutatingRequestsInflight | Jumlah maksimum permintaan API mutating bersamaan. Permintaan yang melebihi batas ini akan ditolak. | 1–1000. Default: blank. |
maxRequestsInflight | Jumlah maksimum permintaan API non-mutating bersamaan. | 1–3000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate Kubernetes tertentu. | Nilai yang didukung: ServerSideApply, TTLAfterFinished, EphemeralContainers, RemoveSelfLink, HPAScaleToZero. Default: blank. Catatan
|
oidcIssuerURL | URL penerbit OIDC untuk integrasi penyedia identitas eksternal. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcClientId | Client ID untuk penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernameClaim | Klaim JWT yang digunakan sebagai username untuk otentikasi OIDC. | Default: sub. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernamePrefix | Awalan yang ditambahkan ke username OIDC untuk menghindari konflik dengan nama yang sudah ada. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsPrefix | Awalan yang ditambahkan ke nama grup OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsClaim | Klaim JWT yang digunakan untuk mengisi grup pengguna dalam otentikasi OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcRequiredClaim | Pasangan kunci-nilai yang harus ada dalam Token ID OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcCAContent | Konten CA dalam format PEM untuk memverifikasi penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
kube-controller-manager
| Parameter | Description | Valid range / notes |
|---|---|---|
horizontalPodAutoscalerSyncPeriod | Frekuensi pengontrol HPA menghitung ulang jumlah replika yang diinginkan. | Default: blank (menggunakan nilai default Kubernetes). |
horizontalPodAutoscalerTolerance | Perubahan rasio minimum yang diperlukan sebelum HPA memicu aksi penskalaan. | Default: blank. |
concurrentTTLAfterFinishedSyncs | Jumlah pekerja konkuren yang membersihkan Pekerjaan selesai yang telah kedaluwarsa TTL-nya. | Default: blank. |
kubeAPIQPS | Maksimum QPS dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
kubeAPIBurst | Maksimum lonjakan permintaan dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate tertentu untuk manajer kontroler. | Nilai yang didukung: TTLAfterFinished. Default: blank. |
kube-scheduler
Kustomisasi kube-scheduler tersedia untuk pengguna dalam daftar izin. Untuk parameter yang didukung, lihat Sesuaikan parameter penjadwal.
Kluster ACK Edge Edisi Pro
kube-apiserver
| Parameter | Description | Valid range / notes |
|---|---|---|
enableAdmissionPlugins | Mengaktifkan plugin admission controller tambahan. | Default: blank. |
serviceNodePortRange | Rentang port untuk layanan NodePort. | 10000–65535. Default: blank. Penting Pastikan rentang ini tidak tumpang tindih dengan |
requestTimeout | Timeout global untuk permintaan API yang tidak memiliki timeout spesifik. | Default: blank (menggunakan nilai default Kubernetes). |
defaultNotReadyTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status NotReady sebelum dievakuasi. | Default: blank. |
defaultUnreachableTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status Unreachable sebelum dievakuasi. | Default: blank. |
maxMutatingRequestsInflight | Jumlah maksimum permintaan API mutating bersamaan. Permintaan yang melebihi batas ini akan ditolak. | 1–1000. Default: blank. |
maxRequestsInflight | Jumlah maksimum permintaan API non-mutating bersamaan. | 1–3000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate Kubernetes tertentu. | Nilai yang didukung: ServerSideApply, TTLAfterFinished, EphemeralContainers, RemoveSelfLink, HPAScaleToZero. Default: blank. Catatan
|
oidcIssuerURL | URL penerbit OIDC untuk integrasi penyedia identitas eksternal. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcClientId | Client ID untuk penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernameClaim | Klaim JWT yang digunakan sebagai username untuk otentikasi OIDC. | Default: sub. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernamePrefix | Awalan yang ditambahkan ke username OIDC untuk menghindari konflik dengan nama yang sudah ada. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsPrefix | Awalan yang ditambahkan ke nama grup OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsClaim | Klaim JWT yang digunakan untuk mengisi grup pengguna dalam otentikasi OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcRequiredClaim | Pasangan kunci-nilai yang harus ada dalam Token ID OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcCAContent | Konten CA dalam format PEM untuk memverifikasi penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
kube-controller-manager
| Parameter | Description | Valid range / notes |
|---|---|---|
horizontalPodAutoscalerSyncPeriod | Frekuensi pengontrol HPA menghitung ulang jumlah replika yang diinginkan. | Default: blank (menggunakan nilai default Kubernetes). |
concurrentTTLAfterFinishedSyncs | Jumlah pekerja konkuren yang membersihkan Pekerjaan selesai yang telah kedaluwarsa TTL-nya. | Default: blank. |
largeClusterSizeThreshold | Ambang batas jumlah node di atas mana kluster dianggap "besar" untuk perhitungan evakuasi. | Default: blank. |
unhealthyZoneThreshold | Proporsi node dalam suatu zona yang harus tidak sehat untuk memicu penurunan laju evakuasi. | Default: blank. |
secondaryNodeEvictionRate | Laju evakuasi node saat kluster berada dalam mode evakuasi sekunder (tereduksi). | Default: blank. |
nodeEvictionRate | Laju evakuasi node dalam kondisi normal. | Default: blank. |
podEvictionTimeout | Durasi setelah itu Pod pada node yang tidak merespons akan dievakuasi. | Default: blank. |
kubeAPIQPS | Maksimum QPS dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
kubeAPIBurst | Maksimum lonjakan permintaan dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate tertentu untuk manajer kontroler. | Nilai yang didukung: TTLAfterFinished. Default: blank. |
cloud-controller-manager (CCM)
| Parameter | Description | Valid range / notes |
|---|---|---|
routeTableIDs | Daftar ID tabel rute VPC yang dipisahkan koma untuk dikelola oleh CCM. | Default: blank. Atur ini jika VPC Anda memiliki beberapa tabel rute. Contoh: vtb-,vtb*. |
kube-scheduler
Untuk parameter kube-scheduler, lihat Sesuaikan parameter penjadwal.
Kluster ACK LINGJUN
kube-apiserver
| Parameter | Description | Valid range / notes |
|---|---|---|
enableAdmissionPlugins | Mengaktifkan plugin admission controller tambahan. | Default: blank. |
serviceNodePortRange | Rentang port untuk layanan NodePort. | 10000–65535. Default: blank. Penting Pastikan rentang ini tidak tumpang tindih dengan |
requestTimeout | Timeout global untuk permintaan API yang tidak memiliki timeout spesifik. | Default: blank (menggunakan nilai default Kubernetes). |
defaultNotReadyTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status NotReady sebelum dievakuasi. | Default: blank. |
defaultUnreachableTolerationSeconds | Durasi kontainer dapat berjalan di node dalam status Unreachable sebelum dievakuasi. | Default: blank. |
maxMutatingRequestsInflight | Jumlah maksimum permintaan API mutating bersamaan. Permintaan yang melebihi batas ini akan ditolak. | 1–1000. Default: blank. |
maxRequestsInflight | Jumlah maksimum permintaan API non-mutating bersamaan. | 1–3000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate Kubernetes tertentu. | Nilai yang didukung: ServerSideApply, TTLAfterFinished, EphemeralContainers, RemoveSelfLink, HPAScaleToZero. Default: blank. Catatan
|
oidcIssuerURL | URL penerbit OIDC untuk integrasi penyedia identitas eksternal. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcClientId | Client ID untuk penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernameClaim | Klaim JWT yang digunakan sebagai username untuk otentikasi OIDC. | Default: sub. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcUsernamePrefix | Awalan yang ditambahkan ke username OIDC untuk menghindari konflik dengan nama yang sudah ada. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsPrefix | Awalan yang ditambahkan ke nama grup OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcGroupsClaim | Klaim JWT yang digunakan untuk mengisi grup pengguna dalam otentikasi OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcRequiredClaim | Pasangan kunci-nilai yang harus ada dalam Token ID OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
oidcCAContent | Konten CA dalam format PEM untuk memverifikasi penyedia OIDC. | Default: blank. Memerlukan versi kluster 1.18 atau lebih baru. |
kube-controller-manager
| Parameter | Description | Valid range / notes |
|---|---|---|
horizontalPodAutoscalerSyncPeriod | Frekuensi pengontrol HPA menghitung ulang jumlah replika yang diinginkan. | Default: blank (menggunakan nilai default Kubernetes). |
horizontalPodAutoscalerTolerance | Perubahan rasio minimum yang diperlukan sebelum HPA memicu aksi penskalaan. | Default: blank. |
concurrentTTLAfterFinishedSyncs | Jumlah pekerja konkuren yang membersihkan Pekerjaan selesai yang telah kedaluwarsa TTL-nya. | Default: blank. |
largeClusterSizeThreshold | Ambang batas jumlah node di atas mana kluster dianggap "besar" untuk perhitungan evakuasi. | Default: blank. |
unhealthyZoneThreshold | Proporsi node dalam suatu zona yang harus tidak sehat untuk memicu penurunan laju evakuasi. | Default: blank. |
secondaryNodeEvictionRate | Laju evakuasi node saat kluster berada dalam mode evakuasi sekunder (tereduksi). | Default: blank. |
nodeEvictionRate | Laju evakuasi node dalam kondisi normal. | Default: blank. |
podEvictionTimeout | Durasi setelah itu Pod pada node yang tidak merespons akan dievakuasi. | Default: blank. |
kubeAPIQPS | Maksimum QPS dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
kubeAPIBurst | Maksimum lonjakan permintaan dari kube-controller-manager ke kube-apiserver. | 1–1000. Default: blank. |
featureGates | Mengaktifkan atau menonaktifkan fitur gate tertentu untuk manajer kontroler. | Nilai yang didukung: TTLAfterFinished. Default: blank. |
cloud-controller-manager (CCM)
| Parameter | Description | Valid range / notes |
|---|---|---|
routeTableIDs | Daftar ID tabel rute VPC yang dipisahkan koma untuk dikelola oleh CCM. | Default: blank. Atur ini jika VPC Anda memiliki beberapa tabel rute. Contoh: vtb-,vtb*. |
kube-scheduler
Untuk parameter kube-scheduler, lihat Sesuaikan parameter penjadwal.