Referensi kolom konfigurasi cluster
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan kolom yang didukung dalam file konfigurasi cluster untuk
software Distributed Cloud khusus untuk bare metal. Untuk setiap kolom, tabel berikut
mengidentifikasi apakah kolom tersebut wajib diisi. Tabel ini juga menunjukkan kolom mana yang dapat diubah, yang berarti kolom mana yang dapat diubah setelah cluster dibuat. Seperti yang tercantum dalam tabel, beberapa kolom yang dapat diubah hanya dapat diubah selama
upgrade cluster.
Membuat template untuk file konfigurasi cluster Anda
Anda dapat membuat file konfigurasi cluster dengan perintah bmctl create config. Meskipun beberapa kolom memiliki nilai default dan kolom lainnya, seperti
metadata.name dapat diisi otomatis, file konfigurasi format YAML ini adalah
template untuk menentukan informasi tentang cluster Anda.
Untuk membuat file konfigurasi cluster baru, gunakan perintah berikut di folder /baremetal:
bmctlcreateconfig-cCLUSTER_NAME
Ganti CLUSTER_NAME dengan nama cluster yang ingin Anda buat. Untuk mengetahui informasi selengkapnya tentang bmctl, lihat alat bmctl.
Untuk contoh file konfigurasi cluster yang dihasilkan, lihat
Contoh file konfigurasi cluster.
Mengisi file konfigurasi Anda
Dalam file konfigurasi, masukkan nilai kolom seperti yang dijelaskan dalam tabel referensi kolom berikut sebelum membuat atau mengupgrade cluster.
Kolom konfigurasi cluster
Nama kolom
Jenis resource
Wajib?
Dapat diubah?
anthosBareMetalVersion
Wajib. String. Versi cluster. Nilai ini ditetapkan untuk pembuatan cluster dan upgrade cluster.
Mutabilitas: Nilai ini tidak dapat diubah untuk cluster yang sudah ada.
Versi hanya dapat diupdate melalui proses upgrade cluster.
Resource cluster
Wajib
Dapat diubah
authentication
Bagian ini berisi setelan yang diperlukan untuk menggunakan OpenID Connect (OIDC).
OIDC memungkinkan Anda menggunakan penyedia identitas yang ada untuk mengelola autentikasi pengguna dan grup di cluster Anda.
Resource cluster
—
—
authentication.oidc.certificateAuthorityData
Opsional.
Sertifikat berenkode PEM berenkode base64 untuk penyedia OIDC. Untuk membuat string, enkode sertifikat, termasuk header, ke dalam base64. Sertakan string yang dihasilkan di
certificateAuthorityData sebagai satu baris.
Misalnya (contoh digabungkan agar sesuai dengan tabel):
Opsional. String. ID untuk aplikasi klien yang membuat permintaan autentikasi ke penyedia OpenID.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.clientSecret
Opsional. String. Rahasia bersama antara aplikasi klien OIDC dan
penyedia OIDC.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.deployCloudConsoleProxy
Opsional. Boolean (true|false). Menentukan apakah reverse proxy
di-deploy di cluster untuk menghubungkan konsol Google Cloud ke
penyedia identitas lokal yang tidak dapat diakses secara publik melalui
internet. Jika penyedia identitas Anda tidak dapat dijangkau melalui internet publik, tetapkan kolom ini ke true untuk melakukan autentikasi dengan konsol Google Cloud . Secara default, nilai ini ditetapkan ke false.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.extraParams
Opsional. Daftar yang dipisahkan koma. Parameter nilai kunci tambahan yang akan dikirim kepada penyedia OpenID.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.groupPrefix
Opsional. String. Awalan ditambahkan ke klaim grup untuk mencegah konflik dengan nama yang sudah ada. Misalnya, dengan grup dev dan awalan
oidc:, oidc:dev.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.group
Opsional. String.
Klaim JWT yang digunakan penyedia untuk menampilkan grup keamanan Anda.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.issuerURL
Opsional. String URL. URL tempat permintaan otorisasi dikirim ke
OpenID Anda, seperti https://example.com/adfs. Server Kubernetes API menggunakan URL ini untuk menemukan kunci publik agar dapat memverifikasi token. URL harus menggunakan HTTPS.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.kubectlRedirectURL
Opsional. String URL. URL pengalihan yang digunakan kubectl untuk
otorisasi. Saat mengaktifkan OIDC, Anda harus menentukan nilai kubectlRedirectURL.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.proxy
Opsional. String URL. Server proxy yang akan digunakan cluster untuk terhubung ke penyedia OIDC Anda, jika ada. Nilai harus menyertakan nama host/alamat IP dan secara opsional port, nama pengguna, dan sandi. Contoh: http://user:password@10.10.10.10:8888.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.scopes
Opsional. Daftar yang dipisahkan koma. Cakupan tambahan yang akan dikirim ke penyedia OpenID. Microsoft Azure dan Okta memerlukan cakupan offline_access.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.usernamePrefix
Opsional. String. Awalan yang ditambahkan ke klaim nama pengguna.
Resource cluster
Opsional
Tidak dapat diubah
authentication.oidc.username
Opsional. String.
Klaim JWT yang akan digunakan sebagai nama pengguna. Jika tidak ditentukan, setelan defaultnya adalah sub.
Resource cluster
Opsional
Tidak dapat diubah
bypassPreflightCheck
Opsional. Boolean (true|false). Jika ditetapkan ke
true, pemeriksaan preflight internal akan diabaikan saat
menerapkan resource ke cluster yang ada. Setelan defaultnya adalah false.
Mutabilitas: Nilai ini dapat diubah untuk cluster yang ada
dengan perintah bmctl update.
Resource cluster
Opsional
Dapat diubah
clusterNetwork
Bagian ini berisi setelan jaringan untuk cluster Anda.
Resource cluster
Wajib
Dapat diubah
clusterNetwork.advancedNetworking
Boolean. Tetapkan kolom ini ke true untuk mengaktifkan fitur jaringan lanjutan, seperti Load Balancing Paket dengan BGP atau gateway NAT egress. Kedua fitur ini menggunakan Gateway Jaringan untuk GDC.
Gateway Jaringan untuk GDC adalah komponen utama untuk mengaktifkan fitur jaringan lanjutan di Google Distributed Cloud dan Google Kubernetes Engine (GKE). Salah satu manfaat utama Gateway Jaringan untuk GDC
adalah dapat mengalokasikan alamat IP mengambang secara dinamis dari
sekumpulan alamat yang Anda tentukan dalam
resource kustom NetworkGatewayGroup.
Boolean. Tetapkan kolom ini ke false untuk menonaktifkan kemampuan Ingress yang dipaketkan dengan software Google Distributed Cloud. Kemampuan Ingress yang dipaketkan untuk cluster Anda hanya mendukung ingress. Jika Anda
berintegrasi dengan Istio atau Cloud Service Mesh untuk mendapatkan manfaat tambahan dari
mesh layanan yang berfungsi penuh, sebaiknya nonaktifkan Ingress
yang dipaketkan. Kolom ini ditetapkan ke true secara default. Kolom ini tidak ada dalam file konfigurasi cluster yang dihasilkan. Anda dapat menonaktifkan Ingress paket hanya untuk cluster versi 1.13.0 dan yang lebih baru.
Untuk mengetahui informasi selengkapnya tentang kemampuan Ingress yang dipaketkan, lihat
Membuat Service dan Ingress.
Resource cluster
Opsional
Dapat diubah
clusterNetwork.flatIPv4
Boolean. Tetapkan kolom ini ke true untuk mengaktifkan model jaringan cluster mode datar. Dalam mode datar, setiap pod memiliki alamat IP uniknya sendiri. Pod dapat berkomunikasi satu sama lain secara langsung tanpa memerlukan gateway perantara atau penafsiran alamat jaringan (NAT).
flatIPv4 adalah false secara default. Anda dapat mengaktifkan mode datar hanya selama pembuatan cluster. Setelah mengaktifkan mode datar untuk cluster, Anda tidak dapat menonaktifkannya.
Resource cluster
Opsional
Tidak dapat diubah
clusterNetwork.forwardMode
Opsional. String. Menentukan mode jaringan untuk load balancing Dataplane V2. Penafsiran alamat jaringan sumber (SNAT) adalah mode jaringan default. Mode Direct Server Return (DSR) mengatasi masalah load balancing SNAT. Dalam mode DSR (forwardMode: dsr), node load balancer menggunakan Opsi IP untuk menyimpan alamat sumber klien.
Mode jaringan untuk load balancing Dataplane V2 hanya dapat dikonfigurasi pada waktu pembuatan cluster.
Wajib. Rentang alamat IPv4 dalam format blok CIDR. Pod menentukan rentang IP tempat jaringan pod dialokasikan.
Rentang Pod CIDR minimum: Nilai mask /18, yang sesuai dengan ukuran 14 bit (16.384 alamat IP).
Rentang Pod CIDR maksimum: Nilai mask
/8, yang sesuai dengan ukuran 24 bit (16.777.216 alamat
IP).
Contoh:
pods:cidrBlocks:-192.168.0.0/16
Resource cluster
Wajib
Tidak dapat diubah
clusterNetwork.sriovOperator
Opsional. Boolean. Tetapkan kolom ini ke true untuk mengaktifkan
jaringan SR-IOV untuk cluster Anda.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan menggunakan jaringan SR-IOV, lihat dokumentasi Menyiapkan jaringan SR-IOV.
Resource cluster
Opsional
Dapat diubah
clusterNetwork.services.cidrBlocks
Wajib. Rentang alamat IPv4 dalam format blok CIDR. Tentukan rentang alamat IP tempat alamat IP virtual (VIP) layanan dialokasikan. Rentang tidak boleh tumpang tindih dengan subnet apa pun yang dapat dijangkau dari jaringan Anda. Untuk mengetahui informasi selengkapnya tentang alokasi alamat untuk internet pribadi, lihat RFC 1918.
Mulai dari rilis software Google Distributed Cloud 1.15.0 untuk bare metal, kolom ini dapat diubah. Jika perlu, Anda dapat meningkatkan jumlah alamat IP yang dialokasikan untuk layanan setelah membuat cluster. Untuk mengetahui informasi selengkapnya, lihat
Meningkatkan rentang jaringan layanan.
Anda hanya dapat meningkatkan rentang CIDR layanan IPv4. Rentang jaringan tidak dapat dikurangi, yang berarti mask (nilai setelah "/") tidak dapat ditingkatkan.
Rentang CIDR Layanan Minimum: Nilai mask
/24, yang sesuai dengan ukuran 8 bit (256
alamat).
Rentang CIDR Layanan Maksimum: Nilai mask /12, yang sesuai dengan ukuran 20 bit (1.048.576 alamat IP).
Contoh:
services:cidrBlocks:-10.96.0.0/12
Resource cluster
Wajib
Dapat diubah
clusterOperations
Bagian ini berisi informasi untuk Cloud Logging dan Cloud Monitoring.
Resource cluster
Wajib
Dapat diubah
clusterOperations.enableApplication
Kolom ini tidak lagi digunakan dan tidak berpengaruh. Logging dan pemantauan aplikasi diaktifkan di resource kustom Google Cloud Observability. Untuk
mengetahui informasi selengkapnya tentang cara mengaktifkan logging dan pemantauan aplikasi, lihat
Mengaktifkan logging dan pemantauan aplikasi.
Resource cluster
No-op
Dapat diubah
clusterOperations.disableCloudAuditLogging
Boolean. Cloud Audit Logs berguna untuk menyelidiki permintaan API yang mencurigakan dan mengumpulkan statistik. Cloud Audit Logs diaktifkan (disableCloudAuditLogging: false) secara default. Tetapkan ke
true untuk menonaktifkan Cloud Audit Logs.
String. Region Google Cloud tempat Anda ingin merutekan dan menyimpan metrik Monitoring. Sebaiknya pilih region yang dekat dengan pusat data lokal Anda. Selama pembuatan cluster, nilai ini digunakan untuk menetapkan nilai clusterLocation dalam spesifikasi resource stackdriver.
Nilai yang Anda tentukan juga digunakan oleh Google Cloud Observability untuk memberi label pada metrik dan log. Label ini dapat digunakan untuk pemfilteran di Metrics Explorer dan Logs Explorer.
Untuk mengetahui informasi selengkapnya tentang lokasi Google Cloud , lihat
Lokasi Global. Untuk mengetahui informasi selengkapnya tentang perutean log dan metrik, lihat Perutean log dan metrik.
Contoh:
location:us-central1
Resource cluster
Wajib
Tidak dapat diubah
clusterOperations.projectID
String. Project ID dari project Google Cloud tempat Anda ingin melihat log dan metrik. Selama pembuatan cluster, nilai ini digunakan untuk menetapkan
nilai projectID dalam spesifikasi resource
stackdriver.
Resource cluster
Wajib
Tidak dapat diubah
controlPlane
Bagian ini berisi informasi tentang bidang kontrol dan komponennya.
Resource cluster
Wajib
Dapat diubah
controlPlane.apiServerCertExtraSANs
Opsional. Array string (nama domain dan alamat IP). Nama alternatif subjek (SAN) adalah fitur sertifikat SSL yang memungkinkan Anda menentukan nama domain dan subdomain yang Anda inginkan untuk validitas sertifikat. Pada cluster untuk bare metal, SAN untuk sertifikat server API menyertakan alamat IP dan VIP node bidang kontrol serta nama DNS Kubernetes secara default. Gunakan kolom ini untuk menambahkan SAN tambahan ke sertifikat server API untuk cluster. Nama domain harus mematuhi RFC 1035.
Untuk mengetahui informasi selengkapnya, lihat Menambahkan domain ke sertifikat server API.
Opsional. Bilangan bulat. Menentukan jumlah pesan ARP serampangan (GARP)
yang akan dikirim Keepalived sekaligus setelah node bidang kontrol
beralih ke peran server master. Nilai ini dipetakan ke setelan vrrp_garp_master_repeat untuk Keepalived. Nilai defaultnya adalah 5. Untuk mengetahui informasi selengkapnya, lihat
Penyesuaian Keepalived.
Resource cluster
Opsional
Dapat diubah
controlPlane.loadBalancer.mode
Opsional. String. Jika ditetapkan ke bundled, setelan ini
menentukan bahwa load balancer bidang kontrol berjalan di node
bidang kontrol. Jika ditetapkan dan Anda mengonfigurasi node pool load balancer dengan
loadBalancer.nodePoolSpec, load balancer bidang kontrol
akan berjalan di node bidang kontrol dan load balancer bidang data
akan berjalan di node pool load balancer. Untuk mengetahui informasi selengkapnya, lihat
Pemisahan
load balancer.
Jika Anda menetapkan controlPlane.loadBalancer.mode ke manual,
loadBalancer.mode juga harus ditetapkan ke manual. Setelan ini digunakan untuk mengaktifkan load balancing manual. Untuk mengetahui informasi selengkapnya, lihat
Mengonfigurasi load balancing manual.
Anda tidak perlu menetapkan controlPlane.loadBalancer.mode
ke manual untuk mengonfigurasi load balancing manual.
Nilai yang diizinkan: bundled | manual
Resource cluster
Opsional
Tidak dapat diubah
controlPlane.nodePoolSpec
Bagian ini menentukan alamat IP untuk node pool yang digunakan oleh
bidang kontrol dan komponennya. Spesifikasi node pool bidang kontrol (seperti spesifikasi node pool load balancer) bersifat khusus. Spesifikasi ini mendeklarasikan dan mengontrol resource cluster penting. Sumber kanonis untuk resource ini adalah bagian ini dalam
file konfigurasi cluster. Jangan mengubah resource node pool bidang kontrol level teratas secara langsung. Ubah bagian terkait di
file konfigurasi cluster.
Resource cluster
Wajib
Dapat diubah
controlPlane.nodePoolSpec.nodes
Wajib. Array alamat IP. Biasanya, array ini adalah
alamat IP untuk satu mesin, atau alamat IP untuk tiga mesin
untuk deployment ketersediaan tinggi (HA).
Kolom ini dapat diubah setiap kali Anda mengupdate atau mengupgrade cluster.
Resource cluster
Wajib
Dapat diubah
controlPlane.nodePoolSpec.nodes.address
Wajib. String (alamat IPv4). Saat menentukan node pool, Anda
menggunakan kolom address untuk menentukan alamat IPv4 default
untuk akses SSH bagi setiap node. Akses SSH diperlukan untuk operasi cluster administratif, seperti penginstalan dan upgrade. Secara default, alamat IP ini juga digunakan untuk data dan traffic Kubernetes. Namun, jika Anda menentukan alamat k8sIP untuk node tertentu, traffic akan dibagi antara dua alamat untuk node tersebut, dengan alamat k8sIP yang digunakan secara eksklusif untuk traffic data dan Kubernetes.
Kolom ini dapat diubah setiap kali Anda mengupdate atau mengupgrade cluster.
Resource cluster
Wajib
Dapat diubah
controlPlane.nodePoolSpec.nodes.k8sIP
Opsional. String (alamat IPv4). Saat Anda menentukan alamat k8sIP opsional untuk sebuah node, alamat tersebut dikhususkan untuk menangani traffic data dan Kubernetes untuk node tersebut, seperti permintaan dan respons untuk Kubernetes API, kubelet, dan workload. Saat Anda menentukan k8sIP,
alamat IP node standar nodePoolSpec.nodes.address
digunakan secara eksklusif untuk koneksi SSH ke node. Jika Anda tidak menentukan alamat k8sIP, alamat IP node standar akan menangani semua traffic untuk node tersebut.
Opsional. Bilangan bulat (non-negatif). Menentukan jumlah maksimum permintaan pull image yang dapat ditambahkan ke antrean pemrosesan untuk menangani lonjakan permintaan. Segera setelah pull dimulai, permintaan baru dapat ditambahkan ke antrean. Nilai defaultnya adalah 10. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryBurst.
Nilai untuk registryPullQPS lebih diprioritaskan daripada setelan ini. Misalnya, dengan setelan default, burst hingga 10 kueri simultan diizinkan, tetapi harus diproses dengan kecepatan default lima kueri per detik. Perilaku burst ini hanya digunakan jika registryPullQPS lebih besar dari 0.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Opsional. Bilangan bulat (non-negatif). Menentukan tingkat pemrosesan untuk kueri penarikan image Artifact Registry dalam kueri per detik (QPS).
Jika registryPullQPS ditetapkan ke nilai yang lebih besar dari 0, kapasitas kueri akan dibatasi ke jumlah kueri per detik tersebut. Jika
registryPullQPS ditetapkan ke 0, tidak ada
batasan pada rasio kueri. Nilai defaultnya adalah 5.
Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryPullQPS.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Opsional. Boolean (true|false). Kolom ini menentukan apakah pull Artifact Registry diproses secara paralel atau satu per satu. Defaultnya adalah true, yang menentukan bahwa pull
diproses satu per satu. Jika disetel ke false, kubelet
akan menarik image secara paralel. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) serializeImagePulls.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Resource cluster
Opsional
Dapat diubah
controlPlane.schedulerConfiguration
Menentukan argumen dan konfigurasi tambahan untuk kube-scheduler.
Kolom ini memungkinkan penentuan batasan penyebaran topologi pod default tingkat cluster.
Menentukan batasan default yang diterapkan ke pod yang tidak memiliki batasan penyebaran topologi yang ditentukan sendiri.
Resource cluster
Opsional
Dapat diubah
gkeConnect
Bagian ini berisi informasi tentang project Google Cloud yang ingin Anda
gunakan untuk menghubungkan cluster ke Google Cloud.
Resource cluster
Wajib
Tidak dapat diubah
gkeConnect.projectID
Wajib: String. ID project Google Cloud yang ingin Anda gunakan untuk menghubungkan cluster ke Google Cloud. Project ini juga disebut sebagai project host fleet.
Nilai ini tidak dapat diubah untuk cluster yang ada.
Resource cluster
Wajib
Tidak dapat diubah
gkeConnect.location
Opsional. String. Nilai default: global.
Keanggotaan fleet untuk cluster Anda dikelola oleh layanan Fleet (gkehub.googleapis.com) dan layanan Connect (gkeconnect.googleapis.com). Keanggotaan fleet dapat bersifat global atau regional. Secara opsional, Anda dapat menggunakan gkeConnect.location
untuk menentukan region Google Cloud tempat layanan Fleet dan Connect
berjalan, sehingga traffic dibatasi ke region Anda.
Cluster yang dibuat pada versi yang lebih rendah dari 1.28 dikelola oleh layanan Fleet dan Connect global.
Cluster baru yang dibuat menggunakan klien API GKE On-Prem, seperti konsol Google Cloud , Google Cloud CLI, atau Terraform, menggunakan region yang sama dengan yang Anda tentukan untuk GKE On-Prem API.
Untuk cluster baru, jika Anda menyertakan kolom ini, region yang Anda tentukan harus sama dengan region yang dikonfigurasi di gkeOnPremAPI.location. Jika region tidak sama, pembuatan cluster akan gagal.
Nilai ini tidak dapat diubah untuk cluster yang ada.
Resource cluster
Opsional
Tidak dapat diubah
gkeOnPremAPI
Di versi 1.16 dan yang lebih baru, jika GKE On-Prem API diaktifkan di project Google Cloud Anda, semua cluster dalam project akan terdaftar di GKE On-Prem API secara otomatis di region yang dikonfigurasi di clusterOperations.location.
Jika Anda ingin mendaftarkan semua cluster dalam project ke GKE On-Prem API, pastikan untuk melakukan langkah-langkah di bagian Sebelum memulai untuk mengaktifkan dan menggunakan GKE On-Prem API dalam project.
Jika Anda tidak ingin mendaftarkan cluster di GKE On-Prem API,
sertakan bagian ini dan tetapkan gkeOnPremAPI.enabled ke
false.
Jika Anda tidak ingin mendaftarkan cluster apa pun dalam project, nonaktifkan
gkeonprem.googleapis.com (nama layanan untuk
GKE On-Prem API) dalam project. Untuk mengetahui petunjuknya, lihat
Menonaktifkan
layanan.
Jika Anda ingin mendaftarkan semua cluster dalam project ke GKE On-Prem API, pastikan untuk melakukan langkah-langkah di bagian Sebelum memulai untuk mengaktifkan dan menggunakan GKE On-Prem API dalam project.
Jika Anda tidak ingin mendaftarkan cluster di GKE On-Prem API,
sertakan bagian ini dan tetapkan gkeOnPremAPI.enabled ke
false.
Jika Anda tidak ingin mendaftarkan cluster apa pun dalam project, nonaktifkan gkeonprem.googleapis.com (nama layanan untuk GKE On-Prem API) dalam project. Untuk mengetahui petunjuknya, lihat
Menonaktifkan
layanan.
Dengan mendaftarkan cluster admin atau pengguna di GKE On-Prem API, Anda dapat menggunakan alat standar—konsol Google Cloud , Google Cloud CLI, atau
Terraform—untuk melihat detail cluster dan mengelola siklus proses cluster. Misalnya, Anda dapat menjalankan perintah gcloud CLI untuk
mendapatkan informasi tentang cluster Anda.
GKE On-Prem API menyimpan metadata status cluster di Google Cloud.
Metadata ini memungkinkan API mengelola siklus proses cluster. Alat standar
menggunakan GKE On-Prem API, dan secara kolektif disebut sebagai
klien GKE On-Prem API.
Jika Anda menetapkan gkeOnPremAPI.enabled ke true,
sebelum membuat atau mengupdate cluster menggunakan bmctl,
pastikan untuk melakukan langkah-langkah di
Sebelum
Anda memulai untuk mengaktifkan dan melakukan inisialisasi GKE On-Prem API.
Setelah Anda menambahkan bagian ini dan membuat atau mengupdate cluster, jika
selanjutnya Anda menghapus bagian tersebut dan mengupdate cluster, update
akan gagal.
Jika Anda lebih suka membuat cluster menggunakan alat standar, bukan bmctl, lihat referensi berikut:
Saat Anda membuat cluster menggunakan alat standar, cluster tersebut akan otomatis didaftarkan di GKE On-Prem API.
Resource cluster
Opsional
gkeOnPremAPI.enabled
Secara default, cluster didaftarkan di GKE On-Prem API jika GKE On-Prem API diaktifkan di project Anda. Tetapkan ke false
jika Anda tidak ingin mendaftarkan cluster.
Setelah cluster didaftarkan di GKE On-Prem API, jika Anda perlu membatalkan pendaftaran cluster, lakukan perubahan berikut, lalu update cluster:
gkeOnPremAPI:enabled:false
Resource cluster
Wajib
Dapat diubah
gkeOnPremAPI.location
Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadata cluster. Pilih salah satu
wilayah yang didukung. Harus berupa string yang tidak kosong jika
gkeOnPremAPI.enabled adalah true. Jika
gkeOnPremAPI.enabled adalah false, jangan
sertakan kolom ini.
Jika bagian ini tidak disertakan dalam file konfigurasi, kolom ini akan ditetapkan ke clusterOperations.location.
Resource cluster
Opsional
Tidak dapat diubah
kubevirt.useEmulation (tidak digunakan lagi)
Tidak digunakan lagi. Mulai rilis 1.11.2, Anda dapat mengaktifkan atau menonaktifkan
Runtime VM di GDC hanya dengan mengupdate resource kustom
VMRuntime.
Boolean. Menentukan apakah emulasi software digunakan untuk menjalankan virtual machine atau tidak. Jika node mendukung virtualisasi hardware, tetapkan
useEmulation ke false untuk performa
yang lebih baik. Jika virtualisasi hardware tidak didukung atau Anda tidak
yakin, tetapkan ke true.
Resource cluster
Opsional
Dapat diubah
loadBalancer
Bagian ini berisi setelan untuk load balancing cluster.
Resource cluster
Wajib
Dapat diubah
loadBalancer.addressPools
Objek. Nama dan array alamat IP untuk kumpulan load balancer cluster Anda. Konfigurasi kumpulan alamat hanya valid untuk mode LB bundled di cluster non-admin. Anda dapat menambahkan kumpulan alamat baru kapan saja, tetapi Anda tidak dapat menghapus kumpulan alamat yang ada.
Kumpulan alamat yang ada dapat diedit untuk mengubah kolom avoidBuggyIPs
dan manualAssign saja.
Resource cluster
Opsional
Tidak dapat diubah
loadBalancer.addressPools.addresses
Array rentang alamat IP. Tentukan daftar rentang IP yang tidak tumpang-tindih untuk load balancer bidang data. Semua alamat harus berada di subnet yang sama dengan node load balancer.
String. Nama yang Anda pilih untuk kumpulan load balancer cluster.
Resource cluster
Wajib
Tidak dapat diubah
loadBalancer.addressPools.avoidBuggyIPs
Opsional. Boolean (true | false). Jika true,
pool akan menghilangkan alamat IP yang diakhiri dengan .0 dan .255.
Beberapa hardware jaringan menghentikan traffic ke alamat khusus ini. Anda
dapat menghapus kolom ini, nilai defaultnya adalah false.
Resource cluster
Opsional
Dapat diubah
loadBalancer.addressPools.manualAssign
Opsional. Boolean (true | false). Jika true, alamat dalam kumpulan ini tidak ditetapkan secara otomatis ke Layanan Kubernetes. Jika true, alamat IP di kumpulan ini hanya digunakan jika ditentukan secara eksplisit oleh layanan. Anda dapat menghapus kolom ini, nilai defaultnya adalah false.
Resource cluster
Opsional
Dapat diubah
loadBalancer.mode
Wajib. String. Menentukan mode load balancing. Dalam mode bundled, software Google Distributed Cloud menginstal load balancer pada node load balancer selama pembuatan cluster. Dalam mode manual, cluster mengandalkan load balancer eksternal yang dikonfigurasi secara manual. Untuk informasi selengkapnya, lihat
Ringkasan load balancer.
Nilai yang diizinkan: bundled | manual
Resource cluster
Wajib
Tidak dapat diubah
loadBalancer.type
Opsional. String. Menentukan jenis load balancing yang dipaketkan yang digunakan,
Lapisan 2 atau Border Gateway Protocol (BGP). Jika Anda menggunakan load balancing standar yang dipaketkan, tetapkan type ke layer2. Jika Anda
menggunakan load balancing
yang dipaketkan dengan BGP, tetapkan type ke bgp. Jika
Anda tidak menetapkan type, nilai defaultnya adalah layer2.
Nilai yang diizinkan: layer2 | bgp
Resource cluster
Opsional
Tidak dapat diubah
loadBalancer.nodePoolSpec
Opsional. Gunakan bagian ini untuk mengonfigurasi node pool load balancer. Node yang Anda tentukan adalah bagian dari cluster Kubernetes dan menjalankan workload serta load balancer reguler. Jika Anda tidak menentukan node pool, node bidang kontrol akan digunakan untuk load balancing. Bagian ini
hanya berlaku jika mode load balancing ditetapkan ke bundled.
Jika Anda ingin mencegah workload berjalan pada node di node pool load balancer, tambahkan taint berikut ke node:
node-role.kubernetes.io/load-balancer:NoSchedule
Software Google Distributed Cloud menambahkan toleransi untuk taint ini ke pod yang diperlukan untuk load balancing.
Resource cluster
Opsional
Dapat diubah
loadBalancer.nodePoolSpec.nodes
Bagian ini berisi array alamat IP untuk node di node pool load balancer Anda.
Secara default, semua node di node pool load balancer harus berada di subnet Lapisan 2 yang sama dengan VIP load balancer yang dikonfigurasi di bagian loadBalancer.addressPools pada file konfigurasi. Namun, jika Anda menentukan alamat IP Kubernetes k8sIP untuk sebuah node, hanya alamat tersebut yang harus berada di subnet Lapisan 2 yang sama dengan VIP load balancer lainnya.
Resource cluster
Opsional
Dapat diubah
loadBalancer.nodePoolSpec.nodes.address
Opsional. String (alamat IPv4). Saat menentukan node pool, Anda
menggunakan kolom address untuk menentukan alamat IPv4 default
untuk akses SSH bagi setiap node. Akses SSH diperlukan untuk operasi cluster administratif, seperti penginstalan dan upgrade. Secara default, alamat IP ini juga digunakan untuk data dan traffic Kubernetes. Namun, jika Anda menentukan alamat k8sIP untuk node tertentu, traffic akan dibagi antara dua alamat untuk node tersebut, dengan alamat k8sIP yang digunakan secara eksklusif untuk data dan traffic Kubernetes.
Meskipun node di node pool load balancer dapat menjalankan workload, node tersebut terpisah dari node di node pool worker. Anda tidak dapat menyertakan node cluster tertentu di lebih dari satu node pool. Alamat IP node yang tumpang-tindih akan memblokir pembuatan cluster dan operasi cluster lainnya.
Opsional. String (alamat IPv4). Saat Anda menentukan alamat k8sIP opsional untuk sebuah node, alamat tersebut dikhususkan untuk menangani traffic data dan Kubernetes untuk node tersebut, seperti permintaan dan respons untuk Kubernetes API, kubelet, dan workload. Saat Anda menentukan k8sIP,
alamat IP node standar nodePoolSpec.nodes.address
digunakan secara eksklusif untuk koneksi SSH ke node. Jika Anda tidak menentukan alamat k8sIP, alamat IP node standar akan menangani semua traffic untuk node tersebut.
Opsional. Bilangan bulat (non-negatif). Menentukan jumlah maksimum permintaan pull image yang dapat ditambahkan ke antrean pemrosesan untuk menangani lonjakan permintaan. Segera setelah pull dimulai, permintaan baru dapat ditambahkan ke antrean. Nilai defaultnya adalah 10. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryBurst.
Nilai untuk registryPullQPS lebih diprioritaskan daripada setelan ini. Misalnya, dengan setelan default, burst hingga 10 kueri simultan diizinkan, tetapi harus diproses dengan kecepatan default lima kueri per detik. Perilaku burst ini hanya digunakan jika registryPullQPS lebih besar dari 0.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Opsional. Bilangan bulat (non-negatif). Menentukan tingkat pemrosesan untuk kueri penarikan image Artifact Registry dalam kueri per detik (QPS).
Jika registryPullQPS ditetapkan ke nilai yang lebih besar dari 0, kapasitas kueri akan dibatasi ke jumlah kueri per detik tersebut. Jika
registryPullQPS ditetapkan ke 0, tidak ada
batasan pada rasio kueri. Nilai defaultnya adalah 5.
Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryPullQPS.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Opsional. Boolean (true|false). Kolom ini menentukan apakah pull Artifact Registry diproses secara paralel atau satu per satu. Defaultnya adalah true, yang menentukan bahwa pull
diproses satu per satu. Jika disetel ke false, kubelet
akan menarik image secara paralel. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) serializeImagePulls.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Resource cluster
Opsional
Dapat diubah
loadBalancer.ports.controlPlaneLBPort
Angka. Port tujuan yang digunakan untuk traffic yang dikirim ke bidang kontrol Kubernetes (server Kubernetes API).
Resource cluster
Wajib
Tidak dapat diubah
loadBalancer.vips.controlPlaneVIP
Wajib. Menentukan alamat IP virtual (VIP) untuk terhubung ke server Kubernetes API. Alamat ini tidak boleh berada dalam rentang alamat IP apa pun yang digunakan untuk kumpulan alamat load balancer, loadBalancer.addressPools.addresses.
Resource cluster
Wajib
Tidak dapat diubah
loadBalancer.vips.ingressVIP
Opsional. String (alamat IPv4). Alamat IP yang telah Anda pilih untuk dikonfigurasi di load balancer untuk traffic masuk.
Resource cluster
Opsional
Tidak dapat diubah
loadBalancer.localASN
Opsional. String. Menentukan nomor sistem otonom (ASN) untuk cluster yang sedang dibuat. Kolom ini digunakan saat menyiapkan solusi load balancing yang dipaketkan yang menggunakan border gateway protocol (BGP).
Untuk mengetahui informasi selengkapnya, lihat
Mengonfigurasi load balancer yang dipaketkan dengan BGP.
Resource cluster
Opsional
Dapat diubah
loadBalancer.bgpPeers
Opsional. Objek (daftar pemetaan). Bagian ini menentukan satu atau
beberapa peer border gateway protocol (BGP) dari jaringan lokal Anda (eksternal ke
cluster). Anda menentukan peer BGP saat menyiapkan bagian load balancing bidang kontrol dari solusi load balancing yang dipaketkan yang menggunakan BGP. Setiap peer ditentukan dengan pemetaan, yang terdiri dari alamat IP, nomor sistem otonom (ASN), dan, secara opsional, daftar satu atau beberapa alamat IP untuk node bidang kontrol. Konfigurasi peering BGP untuk load balancing bidang kontrol tidak dapat diupdate setelah cluster dibuat.
Opsional. String. Nomor sistem otonom (ASN) untuk jaringan yang berisi perangkat peer eksternal. Tentukan ASN untuk setiap peer BGP yang Anda siapkan untuk load balancing bidang kontrol, saat Anda menyiapkan solusi load balancing paket yang menggunakan BGP.
Untuk mengetahui informasi selengkapnya, lihat
Mengonfigurasi load balancer yang dipaketkan dengan BGP.
Resource cluster
Opsional
Dapat diubah
loadBalancer.bgpPeers.controlPlaneNodes
Opsional. Array alamat IP (IPv4). Satu atau beberapa alamat IP untuk node bidang kontrol yang terhubung ke peer BGP eksternal, saat Anda menyiapkan solusi load balancing yang dipaketkan dan menggunakan BGP. Jika Anda tidak menentukan node bidang kontrol, semua node bidang kontrol akan terhubung ke peer eksternal. Jika Anda menentukan satu atau beberapa alamat IP, hanya node yang ditentukan yang akan berpartisipasi dalam sesi peering.
Untuk mengetahui informasi selengkapnya, lihat
Mengonfigurasi load balancer yang dipaketkan dengan BGP.
Resource cluster
Opsional
Dapat diubah
maintenanceBlocks.cidrBlocks
Opsional. Alamat IPv4 tunggal atau rentang alamat IPv4. Tentukan alamat IP untuk mesin node yang ingin Anda tempatkan ke dalam mode pemeliharaan. Untuk mengetahui informasi selengkapnya, lihat
Menempatkan node ke dalam
mode pemeliharaan.
Contoh:
maintenanceBlocks:cidrBlocks:-192.168.1.200# Single machine-192.168.1.100-192.168.1.109# Ten machines
Opsional. Menentukan konfigurasi adaptor untuk penskalaan otomatis Pod horizontal berdasarkan metrik kustom. Kemampuan ini tersedia untuk Pratinjau cluster versi 1.34.
Contoh:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/metrics-adapter:"true"spec:# ... other existing cluster configurations ...metricsAdapter:prometheus:url:"http://prometheus-k8s.monitoring.svc.cluster.local:9090"orgID:"production-environment"auth:configSecretRef:name:prometheus-auth-secretkey:configrules:configMapKeyRefs:-name:my-app-ruleskey:config.yaml
Resource cluster
Opsional
Dapat diubah
metricsAdapter.prometheus
Opsional. Tentukan setelan untuk terhubung ke server Prometheus.
Hal ini memungkinkan penggunaan instance Prometheus Anda sendiri sebagai penyedia metrik kustom untuk penskalaan otomatis Pod horizontal. Saat menentukan kolom metricsAdapter.prometheus, Anda juga harus menentukan kolom metricsAdapter.rules.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.prometheus.url
Diperlukan saat menentukan setelan Prometheus. URL endpoint Prometheus. Dalam hal ini, saat menggunakan Prometheus sebagai penyedia metrik kustom untuk penskalaan otomatis Pod horizontal, gunakan nama domain yang sepenuhnya memenuhi syarat (FQDN) berikut:
prometheus: Nama Layanan Kubernetes (layanan aplikasi Prometheus itu sendiri).
k8s: Nama Namespace Kubernetes tempat layanan berjalan.
svc: Menunjukkan bahwa ini adalah jenis resource Service
dalam cluster.
cluster.local: Akhiran domain default untuk jaringan internal cluster Kubernetes.
Resource cluster
Wajib
Dapat diubah
metricsAdapter.prometheus.orgID
Opsional. String. Tentukan ID organisasi yang akan disertakan dalam header `X-Scope-OrgID`.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.prometheus.auth
Opsional. Bagian ini berisi setelan autentikasi yang diperlukan oleh
pemberi rekomendasi untuk terhubung ke Prometheus. Penskalaan otomatis Pod horizontal mendukung mekanisme autentikasi dasar (nama pengguna dan sandi) dan autentikasi token pemilik. Anda harus menyimpan semua kredensial di Secret menggunakan format kubeconfig. Jika instance Prometheus Anda tidak memerlukan autentikasi, hapus bagian ini.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.prometheus.auth.configSecretRef
Opsional. Tentukan Secret dan kunci di Secret untuk autentikasi.
Wajib ada saat menentukan autentikasi dasar. String. Kunci dalam kolom data Secret yang akan dipilih untuk mengambil kredensial untuk autentikasi. Harus berupa Kunci rahasia yang valid.
Opsional. Boolean (true|false). Defaultnya adalah
false, autentikasi gagal jika Secret atau kunci tidak ditentukan.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.rules
Opsional. Tentukan aturan penemuan metrik untuk adaptor. Jika
metricsAdapter.prometheus diberikan, kolom ini
wajib diisi.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.rules.configMapKeyRefs
Wajib ada saat menentukan kolom metricsAdapter. configMapKeyRefs berisi daftar referensi ke kunci ConfigMap yang berisi konfigurasi aturan. Aturan ini
digabungkan secara berurutan oleh pengontrol.
Resource cluster
Opsional
Dapat diubah
metricsAdapter.rules.configMapKeyRefs.name
Wajib. String. Nama ConfigMap yang berisi aturan.
Resource cluster
Wajib
Dapat diubah
metricsAdapter.rules.configMapKeyRefs.key
Wajib. String. Kunci dalam kolom data ConfigMap yang akan dipilih untuk mengambil aturan. Harus berupa kunci ConfigMap yang valid.
Resource cluster
Wajib
Dapat diubah
nodeAccess.loginUser
Opsional. String. Tentukan nama pengguna non-root yang ingin Anda gunakan untuk akses kemampuan SUDO tanpa sandi ke mesin node di cluster Anda. Kunci SSH Anda,
sshPrivateKeyPath, harus
berfungsi untuk pengguna yang ditentukan. Operasi pembuatan dan update cluster
memeriksa apakah mesin node dapat diakses dengan pengguna dan
kunci SSH yang ditentukan.
Resource cluster
Opsional
Dapat diubah
osEnvironmentConfig.addPackageRepo
Opsional. Boolean (true | false). Menentukan
apakah akan menggunakan server Package Repository Anda sendiri, bukan
repositori apt Docker default. Untuk menggunakan repositori paket Anda sendiri, tetapkan addPackageRepo ke false. Gunakan fitur ini untuk melewati penambahan repositori paket ke setiap mesin bare metal dalam deployment Anda. Untuk mengetahui
informasi selengkapnya, lihat
Menggunakan server Package Repository pribadi.
Resource cluster
Opsional
Tidak dapat diubah
nodeConfig
Bagian ini berisi setelan untuk konfigurasi node cluster.
Resource cluster
Opsional
Dapat diubah (khusus upgrade)
nodeConfig.containerRuntime (tidak digunakan lagi)
Tidak digunakan lagi. Mulai rilis 1.13.0, Google Distributed Cloud hanya mendukung
containerd sebagai runtime container. Kolom containerRuntime tidak digunakan lagi dan telah dihapus dari file konfigurasi cluster yang dihasilkan. Untuk
software Google Distributed Cloud versi 1.13.0 dan yang lebih tinggi, jika file
konfigurasi cluster Anda berisi kolom ini, nilainya harus
containerd.
Resource cluster
Opsional
Dapat diubah (khusus upgrade)
nodeConfig.podDensity
Bagian ini menentukan konfigurasi kepadatan pod.
Resource cluster
Opsional
Tidak dapat diubah
nodeConfig.podDensity.maxPodsPerNode
Opsional. Bilangan bulat. Menentukan jumlah maksimum pod yang dapat dijalankan pada satu node. Untuk cluster yang dikelola sendiri, nilai yang diizinkan untuk
maxPodsPerNode adalah 32–250 untuk
cluster ketersediaan tinggi (HA) dan 64–250
untuk cluster non-HA. Untuk cluster pengguna, nilai yang diizinkan untuk
maxPodsPerNode adalah 32–250.
Nilai default jika tidak ditentukan adalah 110. Setelah cluster
dibuat, nilai ini tidak dapat diperbarui.
Kubernetes menetapkan blok Classless Inter-Domain Routing (CIDR) ke setiap node sehingga setiap pod dapat memiliki alamat IP yang unik. Ukuran blok CIDR sesuai dengan jumlah maksimum pod per node.
Untuk mengetahui informasi selengkapnya tentang cara menetapkan jumlah maksimum pod per node, lihat Jaringan Pod dan Service.
Resource cluster
Opsional
Tidak dapat diubah
nodeConfig.privateRegistries
Bagian ini menentukan konfigurasi registry pribadi tingkat node untuk cluster pengguna. Registry pribadi tingkat node dimaksudkan untuk digunakan dengan workload Anda guna memberi Anda kontrol lebih besar atas pengambilan image dan keamanan terkaitnya.
Jika berlaku, gunakan bagian ini untuk menentukan nama dan namespace
Secret yang dibuat untuk menyimpan sertifikat CA (root CA
server) untuk registry pribadi. Jika registry lokal Anda tidak memerlukan sertifikat TLS pribadi, Anda dapat menghapus blok ini.
Jika beberapa mirror registry mereferensikan secret sertifikat CA di berbagai namespace, termasuk secret yang memiliki nama yang sama, sistem akan menambahkan awalan dengan namespace sumber untuk membuat nama secret sertifikat CA unik di namespace cluster. Jika beberapa registry pribadi mereferensikan secret sertifikat CA dengan nama yang sama di berbagai namespace (kecuali namespace `anthos-creds` atau cluster), sistem akan menambahkan awalan ke nama secret target untuk memastikan nama secret sertifikat CA unik di seluruh namespace. Sistem tidak akan menambahkan awalan ke secret di namespace cluster atau namespace sumber di `anthos-creds`.
Daftar berikut menunjukkan tahap peluncuran per versi untuk mengonfigurasi registry pribadi level node:
String. Kolom ini menentukan host dan port untuk satu registry pribadi. Anda dapat menentukan host dengan nama domain atau alamat IP. Jangan sertakan awalan http atau https.
Kolom host diperlukan saat Anda menentukan registry pribadi untuk cluster pengguna.
Daftar berikut menunjukkan tahap peluncuran per versi untuk mengonfigurasi registry pribadi level node:
Jika berlaku, gunakan bagian ini untuk menentukan nama dan namespace Secret yang dibuat untuk menyimpan kredensial registry pribadi.
Gunakan blok pullCredentialSecretRef saat Anda mengonfigurasi cluster pengguna untuk memberi node akses ke registry pribadi yang memerlukan autentikasi.
Daftar berikut menunjukkan tahap peluncuran per versi untuk mengonfigurasi registry pribadi level node:
Opsional. Bagian ini berisi setelan untuk mengonfigurasi strategi upgrade untuk kumpulan worker node di cluster Anda. Untuk mengetahui informasi selengkapnya, lihat
Upgrade paralel.
Resource cluster
Opsional
Dapat diubah
nodePoolUpgradeStrategy.concurrentNodePools
Opsional. Boolean (0 atau 1). Default: 1.
Kolom ini menentukan apakah akan mengupgrade semua worker node pool untuk cluster secara serentak atau tidak. Secara default (1), upgrade
secara berurutan, satu per satu. Jika Anda menetapkan concurrentNodePools
ke 0, setiap worker node pool dalam cluster akan diupgrade
secara paralel.
Bagian ini berisi informasi konfigurasi untuk health check berkala. Di resource Cluster, satu-satunya setelan yang tersedia untuk health check berkala adalah kolom enable. Untuk mengetahui informasi selengkapnya, lihat Health check berkala.
Resource cluster
Opsional
Dapat diubah
periodicHealthCheck.enable
Opsional. Boolean (true|false). Mengaktifkan atau menonaktifkan health check berkala untuk cluster Anda. Health check berkala diaktifkan secara default di semua cluster. Anda dapat menonaktifkan health check berkala untuk cluster dengan menetapkan kolom periodicHealthCheck.enable ke false.
Untuk mengetahui informasi selengkapnya, lihat
Menonaktifkan health check berkala
Resource cluster
Opsional
Dapat diubah
profile
Opsional. String. Jika profile ditetapkan ke edge
untuk cluster mandiri, konsumsi resource cluster
akan diminimalkan. Profil edge hanya tersedia untuk cluster mandiri.
Profil edge memiliki persyaratan resource sistem yang lebih rendah dan
direkomendasikan untuk perangkat edge dengan batasan resource yang ketat.
Untuk mengetahui persyaratan hardware yang terkait dengan profil edge, lihat
Persyaratan
resource untuk cluster mandiri yang menggunakan profil edge.
Resource cluster
Opsional
Tidak dapat diubah
proxy
Jika jaringan Anda berada di balik server proxy, isi bagian ini.
Jika tidak, hapus bagian ini.
Resource cluster
Opsional
Dapat diubah
proxy.noProxy
String. Daftar alamat IP, rentang alamat IP, nama host, dan nama domain yang dipisahkan koma yang tidak boleh melewati server proxy. Saat cluster Anda mengirim permintaan ke salah satu alamat, host, atau domain ini, permintaan tersebut akan dikirim secara langsung.
Resource cluster
Opsional
Tidak dapat diubah
proxy.url
String. Alamat HTTP server proxy Anda. Sertakan nomor port
meskipun sama dengan port default skema.
Opsional. Boolean (true|false). Mengaktifkan atau menonaktifkan seccomp di seluruh cluster. Jika kolom ini dinonaktifkan,
container tanpa profil seccomp dalam file konfigurasi
cluster akan berjalan tanpa batasan. Jika kolom ini diaktifkan, container yang sama akan diamankan menggunakan profil seccomp default runtime container. Fitur ini diaktifkan secara default.
Setelah pembuatan cluster, kolom ini hanya dapat diubah selama upgrade.
Untuk mengetahui informasi selengkapnya, lihat
Menggunakan seccomp untuk membatasi penampung.
Resource cluster
Opsional
Dapat diubah (khusus upgrade)
clusterSecurity.enableRootlessContainers
Opsional. Boolean (true|false). Mengaktifkan atau menonaktifkan container sistem bare metal tanpa root. Jika kolom ini diaktifkan, container sistem bare metal akan berjalan sebagai pengguna non-root dengan ID pengguna dalam rentang 2000-5000. Jika dinonaktifkan, container sistem bare metal akan berjalan sebagai pengguna root. Secara default, fitur ini diaktifkan. Sebaiknya jangan menonaktifkan fitur ini, karena menjalankan container sebagai pengguna root dapat menimbulkan risiko keamanan. Setelah pembuatan cluster, kolom ini hanya dapat diubah selama upgrade. Untuk mengetahui informasi selengkapnya, lihat Jangan menjalankan container sebagai pengguna root.
Resource cluster
Opsional
Dapat diubah (khusus upgrade)
clusterSecurity.authorization
Opsional. Otorisasi mengonfigurasi akses pengguna ke cluster.
Resource cluster
Opsional
Dapat diubah
clusterSecurity.authorization.clusterAdmin
Opsional. Menentukan administrator cluster untuk cluster ini.
Opsional. Kolom gcpAccounts menentukan daftar akun yang diberi peran kontrol akses berbasis peran (RBAC) Kubernetes clusterrole/cluster-admin. Akun dengan peran ini memiliki akses penuh ke setiap resource di cluster di semua namespace. Kolom ini juga mengonfigurasi kebijakan RBAC yang memungkinkan akun yang ditentukan menggunakan gateway Connect untuk menjalankan perintah kubectl terhadap cluster. Hal ini
memudahkan jika Anda memiliki beberapa cluster untuk dikelola, terutama di
lingkungan hybrid dengan cluster GKE dan
on-premise.
Kolom ini menggunakan array nama akun. Akun pengguna dan akun layanan didukung. Untuk pengguna, Anda menentukan alamat email akun Google Cloud mereka. Untuk akun layanan, tentukan alamat email dalam format berikut: SERVICE_ACCOUNT@PROJECT_ID..
Contoh:
Saat mengupdate cluster untuk menambahkan akun, pastikan untuk menyertakan semua akun dalam daftar (baik akun yang sudah ada maupun akun baru) karena perintah update akan menimpa daftar dengan akun yang Anda tentukan dalam update.
Kolom ini hanya berlaku untuk cluster yang dapat menjalankan workload. Misalnya, Anda tidak dapat menentukan gcpAccounts untuk cluster admin.
Resource cluster
Opsional
Dapat diubah
clusterSecurity.startUIDRangeRootlessContainers
Opsional. Bilangan bulat. Nilai default: 2000. Container sistem
di software Google Distributed Cloud membantu menginstal dan mengelola cluster.
ID pengguna (UID) dan ID grup (GID) yang digunakan oleh container ini dapat dikontrol oleh kolom startUIDRangeRootlessContainers dalam spesifikasi cluster. Container sistem menggunakan UID dan GID dalam rentang startUIDRangeRootlessContainers hingga startUIDRangeRootlessContainers + 2999, yang memberikan rentang 2000-4999 secara default. Saat Anda mengupdate
startUIDRangeRootlessContainers, pilih nilai yang memastikan
ruang UID dan GID yang digunakan oleh container sistem tidak tumpang-tindih
dengan yang ditetapkan ke workload pengguna. Nilai startUIDRangeRootlessContainers hanya dapat diubah selama upgrade.
Wajib. String. Gunakan kolom path untuk menentukan jalur mesin host tempat disk yang terpasang dapat ditemukan. PersistentVolume (PV) lokal dibuat untuk setiap pemasangan. Jalur default-nya adalah
/mnt/localpv-share. Untuk mengetahui petunjuk cara mengonfigurasi pemasangan node, lihat Mengonfigurasi pemasangan node LVP.
Resource cluster
Wajib
Tidak dapat diubah
storage
Bagian ini berisi setelan untuk penyimpanan cluster.
Resource cluster
Wajib
Tidak dapat diubah
storage.lvpNodeMounts
Bagian ini menentukan konfigurasi (jalur) untuk volume persisten lokal yang didukung oleh disk yang terpasang. Anda harus memformat dan memasang disk ini sendiri. Anda dapat melakukan tugas ini sebelum atau setelah pembuatan cluster. Untuk mengetahui informasi selengkapnya, lihat pemasangan node LVP.
Resource cluster
Wajib
Tidak dapat diubah
storage.lvpShare
Bagian ini menentukan konfigurasi untuk volume persisten lokal yang didukung oleh subdirektori dalam sistem file bersama. Subdirektori ini
dibuat secara otomatis selama pembuatan cluster.
Untuk mengetahui informasi selengkapnya, lihat
Berbagi
LVP.
Resource cluster
Wajib
Tidak dapat diubah
storage.lvpShare.path
Wajib. String. Gunakan kolom path untuk menentukan jalur mesin host tempat subdirektori dapat dibuat. PersistentVolume (PV) lokal dibuat untuk setiap subdirektori. Untuk
petunjuk cara mengonfigurasi berbagi LVP, lihat
Mengonfigurasi
berbagi LVP.
Resource cluster
Wajib
Tidak dapat diubah
storage.lvpShare.numPVUnderSharedPath
Wajib. String. Tentukan jumlah subdirektori yang akan dibuat di bagian
lvpShare.path. Nilai defaultnya adalah 5. Untuk
petunjuk cara mengonfigurasi berbagi LVP, lihat
Mengonfigurasi
berbagi LVP.
Resource cluster
Wajib
Tidak dapat diubah
storage.lvpShare.storageClassName
Wajib. String. Tentukan StorageClass yang akan digunakan untuk membuat volume persisten. StorageClass dibuat selama pembuatan cluster. Nilai defaultnya adalah local-shared. Untuk mengetahui petunjuk cara mengonfigurasi berbagi LVP, lihat Mengonfigurasi berbagi LVP.
Resource cluster
Opsional
Tidak dapat diubah
type
Wajib. String. Menentukan jenis cluster. Model deployment standar terdiri dari satu cluster admin dan satu atau beberapa cluster pengguna, yang dikelola oleh cluster admin.
Software Google Distributed Cloud mendukung jenis cluster berikut:
Admin - cluster yang digunakan untuk mengelola cluster pengguna.
Pengguna - cluster yang digunakan untuk menjalankan workload.
Hybrid - cluster tunggal untuk admin dan workload, yang juga dapat mengelola cluster pengguna.
Mandiri - cluster tunggal yang dapat mengelola dirinya sendiri, dan yang juga dapat menjalankan workload, tetapi tidak dapat membuat atau mengelola cluster pengguna lain.
Jenis cluster ditentukan saat pembuatan cluster dan tidak dapat diubah untuk update atau upgrade. Untuk mengetahui informasi selengkapnya tentang cara membuat cluster, lihat Membuat cluster: ringkasan.
Nilai yang diizinkan: admin | user | hybrid | standalone
Nilai ini tidak dapat diubah untuk cluster yang ada.
Opsional. Gunakan bagian ini untuk menentukan mode operasi penskalaan otomatis Pod vertikal. Fitur ini tersedia untuk
Pratinjau untuk cluster versi 1.33
dan yang lebih baru.
Contoh:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/vertical-pod-autoscaler:enablespec:# ... other cluster spec fieldsverticalPodAutoscaling:# Set to true for automated updatesenableUpdater:true# Set to true to reduce recommender memory usageenableMemorySaver:true
Anda dapat mengupdate cluster kapan saja untuk mengaktifkan, menonaktifkan, atau mengonfigurasi penskalaan otomatis Pod vertikal. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan dan menggunakan penskalaan otomatis Pod vertikal, lihat Mengonfigurasi penskalaan otomatis Pod vertikal.
Opsional. Boolean (true|false). Mengaktifkan atau menonaktifkan mode penghemat memori untuk penskalaan otomatis Pod vertikal. Mode penghemat memori mengurangi jejak memori komponen pemberi rekomendasi penskalaan otomatis Pod vertikal. Saat Anda menetapkan enableMemorySaver ke true, pemberi rekomendasi hanya melacak dan menghitung agregasi untuk pod yang memiliki resource kustom VerticalPodAutoscaler yang cocok. Mode penghemat memori
dinonaktifkan (false) secara default.
Penskalaan otomatis Pod vertikal tersedia untuk Pratinjau untuk cluster versi 1.33 dan yang lebih baru. Anda dapat mengupdate cluster kapan saja untuk mengaktifkan,
menonaktifkan mode penghemat memori. Untuk informasi selengkapnya, lihat
Memahami
mode penskalaan otomatis Pod vertikal.
Opsional. Boolean (true|false). Tentukan mode untuk menerapkan rekomendasi resource Pod:
Dalam mode rekomendasi (enableUpdater: false),
penskalaan otomatis Pod vertikal menganalisis penggunaan resource dan memublikasikan
nilai yang direkomendasikan untuk permintaan dan batas CPU dan memori di
bagian status resource kustom
VerticalPodAutoscaler yang Anda buat. Dalam mode rekomendasi, untuk menerapkan setelan resource yang direkomendasikan, Anda harus mengedit resource secara manual.
Dalam mode update otomatis (enableUpdater: true),
penskalaan otomatis Pod vertikal menganalisis penggunaan resource dan memublikasikan
nilai yang direkomendasikan untuk permintaan dan batas CPU dan memori di
bagian status resource kustom VerticalPodAutoscaler
yang Anda buat. Kemudian, penskalaan otomatis Pod vertikal akan otomatis menerapkan rekomendasi.
Secara default, Vertical Pod Autoscaler berjalan dalam mode rekomendasi (enableUpdater: false).
Penskalaan otomatis Pod vertikal tersedia untuk Pratinjau untuk cluster versi 1.33 dan yang lebih baru. Anda dapat mengupdate cluster kapan saja untuk menentukan mode penerapan rekomendasi resource Pod. Untuk informasi selengkapnya, lihat
Memahami
mode penskalaan otomatis Pod vertikal.
Opsional. Tentukan setelan untuk menghubungkan ke server Prometheus.
Kolom konfigurasi cluster ini memungkinkan penggunaan instance Prometheus Anda sendiri sebagai penyedia histori persisten untuk penskalaan otomatis Pod vertikal. Kemampuan ini tersedia untuk Pratinjau untuk cluster versi 1.34. Jika diaktifkan, komponen pemberi rekomendasi dapat mengkueri server Prometheus saat memulai atau memulai ulang untuk mengambil data penggunaan resource historis jangka panjang (metrik penggunaan CPU dan memori) untuk semua Pod terkelola.
Contoh berikut menunjukkan konfigurasi Prometheus yang menggunakan autentikasi dasar:
apiVersion:baremetal.cluster.gke.io/v1kind:Clustermetadata:name:cluster1namespace:cluster-cluster1annotations:preview.baremetal.cluster.gke.io/vertical-pod-autoscaler:enablespec:# ... other cluster spec fieldsverticalPodAutoscaling:...# other vertical Pod autoscaling fieldsprometheus:url:"http://prometheus.prometheus.svc.cluster.local:9090"auth:basicAuth:usernameRef:name:prom-basic-credskey:usernamepasswordRef:name:prom-basic-credskey:password
Diperlukan saat menentukan setelan Prometheus. URL endpoint Prometheus. Saat menggunakan Prometheus sebagai penyedia histori persisten untuk penskalaan otomatis Pod vertikal, gunakan nama domain yang sepenuhnya memenuhi syarat (FQDN) berikut:
prometheus: nama Layanan Kubernetes (layanan aplikasi Prometheus itu sendiri).
prometheus: nama Namespace Kubernetes
tempat layanan berjalan.
svc: Menunjukkan bahwa ini adalah jenis resource Service
dalam cluster.
cluster.local: akhiran domain default untuk jaringan internal cluster Kubernetes.
Resource cluster
Wajib
Dapat diubah
verticalPodAutoscaling.prometheus.auth
Opsional. Bagian ini berisi setelan autentikasi yang diperlukan oleh
pemberi rekomendasi untuk terhubung ke Prometheus. Penskalaan otomatis Pod vertikal mendukung mekanisme autentikasi dasar (nama pengguna dan sandi) dan autentikasi token pemilik. Jika instance Prometheus Anda tidak memerlukan autentikasi, hapus bagian ini.
Jika instance Prometheus Anda menggunakan metode autentikasi yang berbeda, seperti Transport Layer Security (TLS), instance tersebut tidak didukung untuk digunakan dengan fitur penskalaan otomatis Pod vertikal. Untuk persyaratan selengkapnya, lihat
Menggunakan
Prometheus sebagai penyedia histori persisten.
Resource cluster
Opsional
Dapat diubah
verticalPodAutoscaling.prometheus.auth.basicAuth
Opsional. Tentukan nama pengguna dan sandi untuk autentikasi dasar.
Wajib ada saat menentukan autentikasi dasar. String. Kunci dalam kolom data Secret yang akan dipilih untuk mengambil nama pengguna. Harus berupa Kunci rahasia yang valid.
Wajib ada saat menentukan autentikasi dasar. String. Kunci dalam kolom data Secret yang akan dipilih untuk mengambil sandi. Harus berupa Kunci rahasia yang valid.
Wajib ada saat menentukan autentikasi token pemilik. String. Kunci
dalam kolom data Secret yang akan dipilih untuk
mengambil token. Harus berupa Kunci rahasia yang valid.
Opsional. Boolean (true|false). Defaultnya adalah
false, autentikasi gagal jika Secret atau kunci tidak ditentukan.
Resource cluster
Opsional
Dapat diubah
name
Wajib. String. Biasanya, nama namespace menggunakan pola
cluster-CLUSTER_NAME, tetapi
awalan cluster- tidak sepenuhnya diperlukan sejak
rilis software Google Distributed Cloud 1.7.2.
Nilai ini tidak dapat diubah untuk cluster yang ada.
Resource namespace
Wajib
Tidak dapat diubah
clusterName
String. Wajib. Nama cluster tempat Anda menambahkan node pool. Buat resource node pool di namespace yang sama dengan cluster terkait dan referensikan nama cluster di kolom ini. Untuk
mengetahui informasi selengkapnya, lihat
Menambahkan dan menghapus
node pool di cluster.
Opsional. Bilangan bulat (non-negatif). Menentukan jumlah maksimum permintaan pull image yang dapat ditambahkan ke antrean pemrosesan untuk menangani lonjakan permintaan. Segera setelah pull dimulai, permintaan baru dapat ditambahkan ke antrean. Nilai defaultnya adalah 10. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryBurst.
Nilai untuk registryPullQPS lebih diprioritaskan daripada setelan ini. Misalnya, dengan setelan default, burst hingga 10 kueri simultan diizinkan, tetapi harus diproses dengan kecepatan default lima kueri per detik. Perilaku burst ini hanya digunakan jika registryPullQPS lebih besar dari 0.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Resource NodePool
Opsional
Dapat diubah
kubeletConfig.registryPullQPS
Opsional. Bilangan bulat (non-negatif). Menentukan tingkat pemrosesan untuk kueri penarikan image Artifact Registry dalam kueri per detik (QPS).
Jika registryPullQPS ditetapkan ke nilai yang lebih besar dari 0, kapasitas kueri akan dibatasi ke jumlah kueri per detik tersebut. Jika
registryPullQPS ditetapkan ke 0, tidak ada
batasan pada rasio kueri. Nilai defaultnya adalah 5.
Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) registryPullQPS.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Resource NodePool
Opsional
Dapat diubah
kubeletConfig.serializeImagePulls
Opsional. Boolean (true|false). Kolom ini menentukan apakah pull Artifact Registry diproses secara paralel atau satu per satu. Defaultnya adalah true, yang menentukan bahwa pull
diproses satu per satu. Jika disetel ke false, kubelet
akan menarik image secara paralel. Kolom ini sesuai dengan opsi konfigurasi kubelet (v1beta1) serializeImagePulls.
Kolom ini dapat ditetapkan setiap kali Anda membuat, mengupdate, atau mengupgrade cluster dan setelan ini akan tetap ada selama upgrade cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi setelan pull image kubelet.
Resource NodePool
Opsional
Dapat diubah
taints
Opsional. Objek. Taint node memungkinkan Anda menandai node sehingga scheduler menghindari atau mencegah penggunaannya untuk pod tertentu. Taint terdiri dari pasangan nilai kunci dan efek terkait. Nilai key dan value adalah string yang Anda gunakan untuk mengidentifikasi taint dan nilai effect menentukan cara pod ditangani untuk node. Objek taints dapat memiliki
beberapa taint.
Kolom effect dapat menggunakan salah satu nilai berikut:
NoSchedule - tidak ada pod yang dapat dijadwalkan ke node kecuali jika memiliki toleransi yang cocok.
PreferNoSchedule - sistem menghindari penempatan pod yang tidak menoleransi taint pada node, tetapi hal ini tidak diwajibkan.
NoExecute - pod yang tidak menoleransi taint akan segera dikeluarkan, dan pod yang menoleransi taint tidak akan pernah dikeluarkan.
Untuk software Google Distributed Cloud, taint direkonsiliasi ke
node dari node pool kecuali jika anotasi baremetal.cluster.gke.io/label-taint-no-sync
diterapkan ke cluster. Untuk mengetahui informasi selengkapnya tentang taint, lihat Taint dan Toleransi.
Contoh:
taints:-key:statusvalue:testpooleffect:NoSchedule
Resource NodePool
Opsional
Dapat diubah
labels
Opsional. Pemetaan (pasangan nilai kunci).
Label direkonsiliasi ke node dari node pool kecuali jika anotasi baremetal.cluster.gke.io/label-taint-no-sync diterapkan ke cluster. Untuk informasi selengkapnya tentang label, lihat
Label dan Pemilih.
Resource NodePool
Opsional
Dapat diubah
upgradeStrategy
Opsional. Bagian ini berisi setelan untuk mengonfigurasi strategi upgrade untuk node di worker node pool. Untuk mengetahui informasi selengkapnya, lihat
Upgrade paralel.
Catatan: Jangan tambahkan bagian ini untuk node pool bidang kontrol atau load balancer.
Resource NodePool
Opsional
Dapat diubah
upgradeStrategy.parallelUpgrade
Opsional. Bagian ini berisi setelan untuk mengonfigurasi upgrade node paralel untuk worker node pool. Dalam upgrade cluster default yang umum, setiap node cluster diupgrade secara berurutan, satu per satu. Anda dapat mengonfigurasi node pool worker sehingga beberapa worker node diupgrade secara paralel saat Anda mengupgrade cluster. Mengupgrade node secara paralel akan mempercepat upgrade cluster secara signifikan, terutama untuk cluster yang memiliki ratusan node.
Untuk worker node pool, Anda dapat menentukan jumlah node yang akan diupgrade
secara serentak dan Anda dapat menetapkan batas minimum untuk jumlah
node yang dapat menjalankan workload selama proses upgrade.
Opsional. Bilangan bulat (positif). Default: 1. Maks: 15.
Secara default (1), node diupgrade secara berurutan, satu per satu. Saat Anda menetapkan concurrentNodes ke angka yang lebih besar dari 1, kolom ini
menentukan jumlah node yang akan diupgrade secara paralel. Perhatikan batasan berikut untuk concurrentNodes:
Nilainya tidak boleh melebihi nilai yang lebih kecil dari 50 persen jumlah
node dalam node pool, atau angka tetap 15. Misalnya, jika node pool Anda memiliki 20 node, Anda tidak dapat menentukan nilai yang lebih besar dari 10. Jika node pool Anda memiliki 100 node, 15 adalah nilai maksimum yang dapat Anda tentukan.
Jika Anda menggunakan kolom ini bersama dengan kolom minimumAvailableNodes, nilai gabungannya tidak boleh melebihi jumlah total node dalam node pool. Misalnya, jika node pool Anda memiliki 20 node dan
minimumAvailableNodes ditetapkan ke 18,
concurrentNodes tidak boleh melebihi 2.
Upgrade paralel tidak mematuhi
Anggaran Gangguan Pod (PDB).
Jika workload Anda sensitif terhadap gangguan, sebaiknya tentukan minimumAvailableNodes untuk memastikan sejumlah node tetap tersedia untuk menjalankan workload selama proses upgrade. Untuk mengetahui informasi selengkapnya, lihat
Upgrade paralel.
Opsional. Bilangan bulat (non-negatif). Default: Bergantung pada concurrentNodes. Untuk mengetahui detail selengkapnya tentang nilai default untuk minimumAvailableNodes, lihat
Default upgrade paralel. minimumAvailableNodes memungkinkan Anda menentukan jumlah node dalam node pool yang harus tetap tersedia selama proses upgrade. Node dianggap tidak tersedia saat sedang diupgrade secara aktif. Node juga dianggap tidak tersedia jika salah satu kondisi berikut terpenuhi:
Node dalam mode pemeliharaan
Node sedang direkonsiliasi
Node terhenti di tengah-tengah upgrade
Jika Anda menggunakan kolom ini bersama dengan kolom concurrentNodes, nilai gabungannya tidak boleh melebihi jumlah total node dalam node pool. Misalnya, jika node pool Anda memiliki 20 node dan
concurrentNodes ditetapkan ke 10,
minimumAvailableNodes tidak boleh melebihi 10.
Nilai minimumAvailableNodes yang tinggi meminimalkan masalah kapasitas untuk menjadwalkan pod, sehingga membantu melindungi workload selama upgrade cluster. Namun, nilai minimumAvailableNodes yang tinggi
meningkatkan risiko upgrade terhenti saat menunggu node
tersedia. Untuk mengetahui informasi selengkapnya, lihat
Upgrade paralel.
Resource NodePool
Opsional
Dapat diubah
privateRegistries
Opsional. Gunakan bagian ini untuk menentukan registry pribadi yang akan digunakan untuk image workload. Metode konfigurasi registry pribadi di bagian kredensial file konfigurasi cluster ini ditujukan untuk cluster hybrid atau mandiri yang hanya memiliki node pool worker.
String. Kolom ini menentukan host dan port untuk satu registry pribadi. Anda dapat menentukan host dengan nama domain atau alamat IP. Jangan sertakan awalan http atau https.
Kolom host diperlukan saat Anda menentukan registry pribadi untuk cluster hybrid atau mandiri.
Contoh:
-host:10.200.0.2:5007
Kredensial
Opsional
Dapat diubah
privateRegistries.caCertPath
Opsional. String. Jalur file sertifikat CA (CA root server) jika server registry Anda menggunakan sertifikat TLS pribadi. Jika registry lokal Anda tidak memerlukan sertifikat TLS pribadi, Anda dapat menghapus kolom ini.
Kredensial
Opsional
Dapat diubah
privateRegistries.pullCredentialConfigPath
Opsional. String. Jalur
file konfigurasi
Docker CLI, config.json. Docker menyimpan setelan autentikasi dalam file konfigurasi. Kolom ini hanya berlaku untuk penggunaan registry pribadi level node.
Gunakan kolom pullCredentialConfigPath saat Anda
mengonfigurasi cluster hybrid atau mandiri untuk memberi node akses ke registry
pribadi yang memerlukan autentikasi.
Kredensial
Opsional
Dapat diubah
registryMirrors
Opsional. Gunakan bagian ini untuk menentukan mirror registry yang akan digunakan untuk menginstal cluster, bukan Artifact Registry (gcr.io). Untuk mengetahui informasi selengkapnya tentang cara menggunakan mirror registry, lihat Menggunakan mirror registry untuk image container.
String. Endpoint mirror, yang terdiri dari alamat IP dan nomor port server registry. Secara opsional, Anda dapat menggunakan namespace Anda sendiri di server registry, bukan namespace root. Tanpa
namespace, format endpoint adalah
REGISTRY_IP:PORT. Saat Anda menggunakan namespace, format endpoint-nya adalah REGISTRY_IP:PORT/v2/NAMESPACE.
/v2 diperlukan saat menentukan namespace.
Kolom endpoint wajib ada saat Anda menentukan
mirror registry. Anda dapat menentukan beberapa mirror dan endpoint.
Opsional. String. Jalur file sertifikat CA (CA root server) jika server registry Anda menggunakan sertifikat TLS pribadi. Jika registry lokal Anda tidak memerlukan sertifikat TLS pribadi, Anda dapat menghapus kolom ini.
Mirror registry
Opsional
Dapat diubah
registryMirrors.pullCredentialConfigPath
Opsional. String. Jalur
file konfigurasi Docker CLI, config.json. Docker menyimpan setelan autentikasi dalam file konfigurasi. Kolom ini hanya berlaku untuk penggunaan mirror registry. Jika server registry Anda tidak memerlukan file konfigurasi Docker untuk autentikasi, setelan defaultnya adalah false.
Opsional. Array nama domain untuk host yang diduplikasi secara lokal
untuk mirror registry tertentu (endpoint). Saat
runtime container menemukan permintaan pull untuk image dari host
yang ditentukan, runtime container akan memeriksa mirror registry lokal terlebih dahulu. Untuk informasi tambahan, lihat Membuat cluster dari mirror registry.
File konfigurasi cluster yang dihasilkan oleh bmctl
mencakup kolom untuk menentukan jalur ke file kredensial dan kunci dalam
sistem file lokal. Kredensial dan kunci ini diperlukan untuk menghubungkan
cluster Anda satu sama lain dan ke project Google Cloud Anda.
String. Jalur ke kunci akun layanan yang memiliki izin IAM yang diperlukan untuk mengakses resource Artifact Registry.
Kredensial
Opsional
Dapat diubah
sshPrivateKeyPath
String. Jalur ke kunci pribadi SSH. SSH diperlukan untuk akses Node.
Kredensial
Opsional
Dapat diubah
gkeConnectAgentServiceAccountKeyPath
String. Jalur ke kunci akun layanan agen.
Google Distributed Cloud menggunakan akun layanan ini untuk mempertahankan koneksi antara cluster lokal Anda dan Google Cloud.
String. Jalur ke kunci akun layanan pendaftaran.
Google Distributed Cloud menggunakan akun layanan ini untuk mendaftarkan cluster pengguna Anda dengan Google Cloud.
String. Jalur ke kunci akun layanan operasi.
Google Distributed Cloud menggunakan akun layanan operasi untuk
melakukan autentikasi dengan Google Cloud Observability guna mengakses
Logging API dan Monitoring API. Kecuali untuk cluster pengguna, kunci akun layanan operasi diperlukan. Cluster pengguna menggunakan kredensial yang ditentukan untuk cluster pengelola (admin atau hybrid).
Anda tidak dapat menonaktifkan Cloud Logging dan Cloud Monitoring untuk cluster Anda.
Menentukan konfigurasi untuk rentang CIDR IPv4. Setidaknya salah satu kolom
ipv4 atau ipv6 harus diberikan untuk
resource ClusterCidrConfig.
Resource ClusterCIDRConfig
Opsional
Tidak dapat diubah
ipv4.cidr
String. Menetapkan blok CIDR node IPv4. Node hanya dapat memiliki satu rentang dari setiap kelompok. Blok CIDR ini harus cocok dengan CIDR pod yang dijelaskan dalam resource Cluster.
Contoh:
ipv4:cidr:"10.1.0.0/16"
Resource ClusterCIDRConfig
Wajib
Tidak dapat diubah
ipv4.perNodeMaskSize
Bilangan bulat. Menentukan ukuran mask untuk blok CIDR IPv4 node. Misalnya, nilai 24 diterjemahkan ke netmask /24. Pastikan netmask blok CIDR node lebih besar dari jumlah maksimum pod yang dapat dijadwalkan kubelet, yang ditentukan dalam flag --max-pods kubelet.
Resource ClusterCIDRConfig
Wajib
Tidak dapat diubah
ipv6
Menentukan konfigurasi untuk rentang CIDR IPv6. Setidaknya salah satu kolom
ipv4 atau ipv6 harus diberikan untuk
resource ClusterCidrConfig.
Resource ClusterCIDRConfig
Opsional
Tidak dapat diubah
ipv6.cidr
String. Menetapkan blok CIDR node IPv6. Node hanya dapat memiliki satu rentang dari setiap kelompok.
Contoh:
ipv6:cidr:"2620:0:1000:2631:3:10:3:0/112"
Resource ClusterCIDRConfig
Wajib
Tidak dapat diubah
ipv6.perNodeMaskSize
Bilangan bulat. Menentukan ukuran mask untuk blok CIDR IPv6 node. Misalnya, nilai 120 diterjemahkan ke netmask /120. Pastikan netmask blok CIDR node lebih besar dari jumlah maksimum pod yang dapat dijadwalkan kubelet, yang ditentukan dalam flag --max-pods kubelet.
Resource ClusterCIDRConfig
Wajib
Tidak dapat diubah
nodeSelector.matchLabels
Menentukan node mana yang dapat menerapkan konfigurasi CIDR. Pemilih node yang kosong berfungsi sebagai default yang berlaku untuk semua node.
