Halaman ini mencantumkan masalah umum GKE. Halaman ini ditujukan untuk Admin dan arsitek yang mengelola siklus proses infrastruktur teknologi yang mendasarinya, serta merespons pemberitahuan dan halaman saat tujuan tingkat layanan (SLO) tidak terpenuhi atau aplikasi gagal.
Halaman ini mencantumkan masalah umum untuk semua versi yang didukung dan untuk dua versi minor yang langsung mendahului versi paling awal dalam dukungan yang diperpanjang. Setelah versi mencapai akhir dukungan yang diperpanjang, semua masalah N-2 akan dihapus. Misalnya, saat versi 1.30 mencapai akhir dukungan yang diperpanjang, masalah umum yang khusus untuk versi 1.28 dan yang lebih lama akan dihapus.
Jika Anda adalah bagian dari Google Developer Program, simpan halaman ini untuk menerima notifikasi saat catatan rilis yang terkait dengan halaman ini dipublikasikan. Untuk mempelajari lebih lanjut, lihat Halaman Tersimpan.
Untuk memfilter masalah umum menurut versi atau kategori produk, pilih filter Anda dari menu drop-down berikut.
Pilih versi GKE Anda:
Pilih kategori masalah Anda:
Atau, telusuri masalah Anda:
| Kategori | Versi yang diidentifikasi | Versi tetap | Masalah dan solusinya |
|---|---|---|---|
| Upgrade dan update |
|
Workload Sandbox Agen gagal setelah upgrade cluster
Addon Agent Sandbox ( Solusi:
Sebelum mengupgrade bidang kontrol cluster ke 1.36.3-gke.1767000 atau
yang lebih baru, migrasikan manifes dan workload Agent Sandbox Anda dari
|
|
| Operasi |
|
|
Permintaan POST HTTP untuk token dari server metadata gagal dengan error 400 Bad Request
Workload yang menggunakan Workload Identity Federation for GKE
untuk melakukan autentikasi ke API Google Cloud dengan meminta token akses akun layanan atau token identitas
dari server metadata GKE (seperti
Masalah ini terjadi saat aplikasi, library klien, atau gateway API mengirim permintaan HTTP Untuk memperbaiki masalah ini, upgrade ke versi patch terbaru dalam versi minor saluran rilis mana pun. Solusi:
Untuk mengatasi masalah ini, konfigurasikan aplikasi, library klien, atau gateway API Anda
untuk menggunakan metode curl -H "Metadata-Flavor: Google" "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token"
Jika workload Anda menggunakan SDK atau gateway pihak ketiga (seperti MuleSoft Flex Gateway, IBM App Connect, atau skrip HTTP kustom) yang secara default mengirim permintaan |
| Upgrade dan update |
|
Ditentukan Nanti |
Pod yang tidak terjadwal dan kuota yang habis selama upgrade minor dua langkah untuk bidang kontrol.
Selama upgrade versi minor dua langkah untuk bidang kontrol di cluster Autopilot yang menggunakan
Pod durasi yang diperpanjang, node pool
baru mungkin disediakan menggunakan versi node sebelumnya. Autoscaler Cluster mengevaluasi node yang baru disediakan terhadap versi bidang kontrol yang diupgrade, mendeteksi ketidakcocokan versi, dan menerapkan taint Perilaku ini mencegah Pod dijadwalkan dan memicu loop penskalaan tanpa batas. Alih-alih meningkatkan skala node pool yang ada, node auto-provisioning akan membuat node pool baru dengan satu node pada setiap iterasi peningkatan skala untuk mengakomodasi workload yang tertunda. Loop ini menghasilkan ratusan node pool kosong terpisah yang pada akhirnya dapat menghabiskan kuota grup instance terkelola regional. Solusi: Untuk menyelesaikan loop penskalaan, selesaikan upgrade bidang kontrol secara manual dengan menjalankan perintah berikut: Atau, terapkan toleransi berikut ke workload yang terpengaruh agar dapat dijadwalkan pada node versi sebelumnya: |
| Operasi | 1.37.0-gke.2941000 dan yang lebih baru | 1.37.1-gke.1131000 |
Node yang memasang volume NFS mengumpulkan entri pemasangan dan berhenti membuat containerPada node yang menjalankan versi yang terpengaruh, pemasangan volume NFS akan menyisakan entri tambahan di tabel pemasangan node. Selain itu, saat Pod yang menggunakan volume NFS dihentikan, upaya untuk melepas gagal, sehingga Saat tabel pemasangan mencapai batas kernel, runtime container tidak dapat lagi membuat container di node tersebut. Node berhenti menjalankan Pod baru, mungkin melaporkan status Dalam peristiwa Pod dan log MountVolume.SetUp failed for volume "VOLUME_NAME" : mount failed: exit status 1 mount: /etc: mount(2) system call failed: No space left on device Masalah ini memengaruhi node pool yang memasang volume NFS dengan driver NFS in-tree Kubernetes. Node yang tidak menggunakan driver NFS dalam hierarki untuk memasang volume NFS tidak akan terpengaruh. Solusi: Untuk memulihkan node yang terpengaruh, mulai ulang atau buat ulang node tersebut. Entri pemasangan tambahan hanya ada dalam status node yang berjalan, sehingga akan dihapus saat node dimulai ulang. Pod yang terjebak dalam status kubectl delete pod POD_NAME --namespace NAMESPACE --force --grace-period=0 Untuk mencegah masalah ini terulang di cluster Standard, downgrade node pool yang memasang volume NFS ke versi 1.36. Tetapkan pengecualian pemeliharaan agar GKE tidak otomatis mengupgrade node pool kembali ke versi yang terpengaruh. Jika cluster Autopilot menjalankan versi yang terpengaruh, gunakan salah satu opsi berikut:
|
| Upgrade | 1.34.9-gke.1065000 dan yang lebih baru, 1.35.6-gke.1049000 dan yang lebih baru, serta semua versi patch 1.36 | 1.34.10-gke.1328000 dan yang lebih baru, 1.35.8-gke.1026000 dan yang lebih baru, 1.36.4-gke.1058000 dan yang lebih baru (belum ada perbaikan untuk 1.37) |
Kegagalan workload GPU A4X Max (GB300)Membuat atau mengupgrade node pool GKE A4X Max ( Solusi: Upgrade setiap cluster dan node pool yang terpengaruh ke versi yang diperbaiki. GKE mencegah pembuatan node pool A4X Max dengan versi yang terpengaruh, dan tidak akan otomatis mengupgrade node pool ke versi yang terpengaruh. GKE tidak mencegah upgrade manual ke versi yang terpengaruh. Namun, untuk menghindari kegagalan, sebaiknya jangan mengupgrade ke versi yang terpengaruh. Solusi: Jika Anda tidak dapat mengupgrade, hapus semua node pool A4X Max yang menjalankan versi yang terpengaruh, dan buat ulang node pool menggunakan versi sebelumnya yang tidak terpengaruh. Perhatikan bahwa karena kapasitas A4X Max harus diperoleh melalui pemesanan, Anda tidak akan kehilangan kapasitas apa pun dengan menghapus node pool. |
| Operasi | Versi 1.33 sebelum 1.33.5-gke.2469000, versi 1.34 sebelum 1.34.1-gke.2037001 | 1.33.5-gke.2469000 dan yang lebih baru, 1.34.1-gke.2037001 dan yang lebih baru, 1.35 dan yang lebih baru |
Node GPU atau TPU terjebak dengan taint impending-node-termination setelah pemeliharaan hostPada cluster GKE dengan node akselerator (GPU atau TPU) yang menjalankan versi yang terpengaruh, node mungkin macet dengan taint Solusi: Untuk mengatasi status macet, Anda harus menghapus label pemeliharaan aktif yang dikelola GKE dan taint secara manual dari node yang terpengaruh. Jika Anda hanya menghapus taint, pengontrol pemeliharaan GKE akan otomatis menerapkannya kembali. Untuk menghapus label dan taint, jalankan perintah berikut: kubectl label nodes NODE_NAME cloud.google.com/active-node-maintenance- kubectl label nodes NODE_NAME cloud.google.com/scheduled-maintenance-time- kubectl label nodes NODE_NAME cloud.google.com/scheduled-maintenance-time-latest- kubectl taint nodes NODE_NAME cloud.google.com/impending-node-termination- kubectl taint nodes NODE_NAME cloud.google.com/maintenance-window-started- Ganti |
| Operasi |
|
1.34.1-gke.1829001 dan yang lebih baru |
Kegagalan penerimaan pod untuk workload TPU v7 karena melaporkan jumlah chip yang salah.GKE salah memberitahukan delapan chip TPU yang dapat dialokasikan untuk akselerator TPU v7 (tpu7x) dengan topologi 2x2x1, yang secara fisik hanya berisi empat chip. Ketidakcocokan pelaporan ini mencegah penjadwalan Pod untuk workload TPU v7. Arsitektur dual-chiplet TPU v7 tidak ditangani dengan benar di versi sebelumnya, sehingga menyebabkan kegagalan penerimaan Pod. Bergantung pada resource TPU yang diminta, error berikut akan terjadi:
Solusi: Untuk mengatasi masalah ini, upgrade cluster GKE ke versi 1.34.1-gke.1829001 atau yang lebih baru. |
| Operasi | 1.35.3-gke.1234000 dan yang lebih baru | Ditentukan Nanti |
Klien Lustre tidak menggunakan NIC sekunder pada node multi-NICPada node GKE dengan beberapa Kartu Antarmuka Jaringan (NIC), driver CSI Managed Lustre diaktifkan secara default untuk menggunakan semua NIC yang tersedia guna menggabungkan bandwidth dengan menyebarkan traffic penyimpanan TCP ke seluruh antarmuka jaringan. Namun, karena masalah umum, klien Lustre mulai dari versi Solusi: Jika workload Anda memerlukan agregasi bandwidth multi-NIC untuk Managed Lustre, downgrade node pool Anda ke versi GKE sebelum 1.35.3-gke.1234000, seperti 1.35.2-gke.1842000. |
| Operasi | 1.35 dan yang lebih baru | Ditentukan Nanti |
Waktu tunggu koneksi habis atau koneksi ditolak untuk alur yang dialihkan ke server metadata GKEDi GKE versi 1.35 dan yang lebih baru, workload yang menggunakan Workload Identity untuk melakukan autentikasi ke Google Cloud API mungkin mengalami waktu tunggu konektivitas sementara atau koneksi yang ditolak ke server metadata GKE segera setelah startup node. Solusi: Untuk rekomendasi dan solusi, lihat memecahkan masalah error waktu tunggu saat memulai Pod. |
| Operasi | 1.33.8-gke.1026000 dan yang lebih baru | 1.35.1 dan yang lebih baru |
Shim gVisor gagal melakukan pembersihan, mencatat error
|
| Operasi | 1.35.0-gke.2232000 dan yang lebih baru | 1.35.3-gke.1.35.3-gke.1290000 dan yang lebih baru |
Volume dinamis beralih ke jenis disk defaultWorkload yang menggunakan volume dinamis di GKE versi 1.35.0-gke.2232000 atau yang lebih baru mungkin gagal dijadwalkan atau dipasang. Masalah ini juga dapat menyebabkan volume disediakan menggunakan Hal ini terjadi karena server Node PDCSI gagal mengisi objek Solusi: Upgrade ke 1.35.3-gke.1290000 atau yang lebih baru. |
| Upgrade dan update |
|
|
Masalah startup pod selama upgrade ke GKE 1.35 untuk cluster GKE Dataplane V2Cluster yang mengupgrade bidang kontrol ke GKE versi 1.35.0-gke.2232000 dan yang lebih baru dari versi
anetd.
Workload baru akan gagal dimulai selama peluncuran
Hal ini terjadi karena GKE menggunakan Operator identity-management-mode yang mengharuskan semua agen dan operator memiliki tampilan label yang relevan dengan identitas yang disinkronkan. Mulai GKE 1.35.0-gke.2232000, label Solusi:
|
| Upgrade dan update |
|
|
Penundaan penjadwalan pod pada node baru dengan kebijakan jaringan Calico yang diaktifkan
Pada cluster GKE dengan kebijakan jaringan Calico yang diaktifkan, regresi
dalam versi yang terpengaruh dapat menyebabkan penundaan yang signifikan dalam penjadwalan Pod pada node baru atau yang dibuat ulang.
Penundaan ini dapat menyebabkan node tetap dalam status Masalah ini disebabkan oleh skrip startup CNI Calico yang salah memformat URL server Kubernetes API untuk alamat IPv4 dengan menyertakannya dalam tanda kurung siku ([]). Pendekatan ini menyebabkan error penguraian URL saat membuat sandbox Pod baru, yang terlihat di log `kubelet`:
Solusi: Versi komponen Calico ditentukan oleh versi bidang kontrol cluster. Untuk mengurangi masalah ini, upgrade bidang kontrol cluster Anda ke salah satu versi yang telah diperbaiki. Setelah mengupgrade bidang kontrol, Anda harus membuat ulang node di node pool untuk memastikan node tersebut menggunakan format URL server Kubernetes API yang benar. Anda dapat melakukannya dengan melakukan upgrade langsung pada node pool ke versi yang sama atau lebih baru, atau dengan membuat ulang node pool secara manual. |
| Performa |
|
|
Performa jaringan tujuan umum menurun pada jenis mesin GPU seri A dan G4Cluster GKE dengan node GPU seri A dan G4 menunjukkan penurunan performa untuk jaringan tujuan umum di GKE 1.32.8-gke.1134000 dan yang lebih baru untuk GKE 1.32, serta di GKE 1.33.3-gke.1392000 dan yang lebih baru. Penurunan performa pada jaringan tujuan umum memengaruhi jenis mesin GPU, termasuk seri mesin A3, seri mesin A4, seri mesin A4X, dan seri mesin G4. Perhatikan bahwa GPUDirect-TCPXO di A3 Mega dan GPUDirect-RDMA di A3 Ultra, A4, dan A4X tidak terpengaruh. Hal ini terjadi karena skrip level node ( Solusi: Upgrade setiap node pool yang terpengaruh ke versi yang telah diperbaiki. |
| Performa |
|
|
Performa GPUDirect-TCPX menurun di A3 HighCluster GKE dengan node A3 High ( Hal ini terjadi karena skrip level node ( Solusi: Untuk node pool GKE 1.32, upgrade versi node pool GKE ke 1.32.11-gke.1075000 atau yang lebih baru. Untuk nodepool GKE 1.33 dan yang lebih baru, upgrade versi nodepool GKE ke 1.33.5-gke.2392000 atau yang lebih baru.1392000. Untuk node pool GKE 1.34, lihat GPUDirect-TCPX tidak tersedia dengan A3 High untuk GKE versi 1.34 dan yang lebih baru. |
| Upgrade | 1,35 |
1.35.0-gke.2232000 dan yang lebih baru. |
Duplikasi identitas Cilium di cluster GKE Dataplane V2Cluster GKE yang menjalankan versi 1.35 dengan GKE Dataplane V2 diaktifkan mungkin mengalami peningkatan jumlah resource kustom Di cluster Regional dan Zona, menjadwalkan workload baru dapat menyebabkan duplikasi identitas Cilium sementara. Duplikasi ini terjadi karena Pod mendapatkan satu identitas pada waktu pembuatan berdasarkan label awal, dan identitas lain setelah label topologi ditambahkan saat Pod dijadwalkan ke node. Di cluster Regional, jumlah identitas mungkin juga meningkat dengan faktor yang sebanding dengan jumlah zona yang dicakup cluster. Dampak: Jika jumlah total identitas melebihi 65.535, workload baru mungkin gagal dijadwalkan. Solusi: Untuk membatasi jumlah total identitas, hindari menambahkan label dengan sejumlah besar nilai unik ke Pod Anda. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Cilium berikut: Upgrade manual harus dilakukan dari versi 1.34.3-gke.1208000 dan yang lebih baru. Jika Anda memulai upgrade dari versi yang lebih lama dari 1.34.3-gke.1208000, Anda mungkin mengalami masalah sementara pada penjadwalan Pod selama proses upgrade. |
| Upgrade |
|
Anda juga harus menggunakan penginstal GPUDirect-TCPX versi 3.1.9 atau yang lebih baru dan sidecar versi 2.0.12 atau yang lebih baru. Versi penginstal dan sidecar memiliki pemetaan satu-ke-satu dan harus sesuai. Misalnya, penginstal GPUDirect-TCPX versi 3.1.12 sesuai dengan sidecar versi 2.0.15. Untuk mengetahui informasi selengkapnya tentang versi penginstal dan sidecar, lihat Catatan Rilis GPUDirect-TCPX. |
GPUDirect-TCPX tidak tersedia dengan A3 High untuk versi GKE tertentuCluster GKE dengan node A3 High ( Jenis mesin GPU A3 High lainnya ( Solusi: Upgrade ke patch versi GKE yang telah diperbaiki untuk menyelesaikan masalah ini. Untuk mengetahui detail tentang cara mengonfigurasi dan mengupgrade node pool dengan GPUDirect-TCPX, lihat Memaksimalkan bandwidth jaringan GPU di cluster Standard atau Memaksimalkan bandwidth jaringan GPU di cluster Autopilot. Saat menjalankan pengujian NCCL pada versi tetap, Anda mungkin melihat peringatan berikut yang tidak berdampak pada performa atau fungsi:
|
| Operasi | Semua versi sebelum 1.34.0-gke.2285000 | 1.34.0-gke.2285000 dan yang lebih baru |
Kapasitas instance minimum yang diperbaruiKapasitas minimum untuk instance Managed Lustre telah diperbarui menjadi 9.000 GiB. Cluster yang menjalankan versi sebelum 1.34.0-gke.2285000 tidak dapat membuat instance dengan kapasitas minimum ini melalui driver CSI Managed Lustre. Solusi: Upgrade versi cluster Anda ke 1.34.0-gke.2285000 atau yang lebih baru untuk mengaktifkan pembuatan instance Managed Lustre dengan kapasitas minimum 9.000 GiB. |
| Operasi | Semua versi | Ditentukan Nanti |
UI konsolGoogle Cloud menjadi tidak dapat diedit selama perbaikan otomatis nodeSaat node GKE sedang menjalani perbaikan otomatis, node pool tidak dapat diedit melalui konsol Google Cloud karena operasi yang sedang berlangsung. Solusi: Anda masih dapat mengedit konfigurasi node pool menggunakan perintah gcloud CLI. |
| Operasi | Versi 1.33 sebelum 1.33.4-gke.1036000 | 1.33.4-gke.1036000 dan yang lebih baru |
Tingkat performa yang salah untuk instance Lustre yang disediakan secara dinamisSaat menyediakan instance Lustre secara dinamis, pembuatan instance akan gagal dengan error Solusi: Upgrade cluster GKE ke versi 1.33.4-gke.1036000 atau yang lebih baru. Jika menggunakan saluran Stabil, versi yang lebih baru mungkin belum tersedia. Dalam hal ini, Anda dapat memilih versi secara manual dari saluran Regular atau Rapid yang menyertakan perbaikan. |
| Operasi |
|
1.33.3-gke.1266000 dan yang lebih baru |
Error input/output saat mengganti nama atau memindahkan file menggunakan driver CSI Cloud Storage FUSESaat menggunakan versi driver CSI Cloud Storage FUSE yang terpengaruh, penggantian nama atau pemindahan file di bucket Cloud Storage mungkin gagal dengan error I/O. Solusi: Tambahkan definisi image file bantuan tertentu ke manifes Pod Anda untuk sementara. Di bagian # Add the following block to use the fixed sidecar image - name: gke-gcsfuse-sidecar image: gcr.io/gke-release/gcs-fuse-csi-driver-sidecar-mounter:v1.8.9-gke.2 Untuk mengetahui informasi selengkapnya, lihat manifes Pod di Mengonfigurasi image pribadi untuk container sidecar. Setelah mengupgrade cluster ke versi GKE yang diperbaiki atau yang lebih baru, Anda harus menghapus seluruh blok |
| Logging dan pemantauan | Semua versi | Ditentukan Nanti |
Kondisi race di DaemonSet
|
| Upgrade | 1,33 | 1.33.2-gke.1043000 |
Batas file terbuka yang lebih rendah dengan containerd 2.0Untuk node pool yang menjalankan GKE versi 1.33, yang menggunakan containerd 2.0, batas ringan default untuk file terbuka ( Ini adalah perubahan pada containerd itu sendiri (lihat PR containerd #8924) saat Workload yang mengharapkan batas sementara default yang lebih tinggi (misalnya, workload yang secara implisit mengandalkan batas default yang lebih tinggi sebelumnya) mungkin mengalami kegagalan, seperti error Solusi: Upgrade dari versi patch 1.33 yang lebih lama ke 1.33.2-gke.1043000 atau yang lebih baru. Solusi: Tingkatkan batas file yang dapat dibuka untuk workload Anda menggunakan salah satu metode berikut:
|
| Upgrade | 1.31.5-gke.1169000, 1.32.1-gke.1376000 | 1.31.7-gke.1164000, 1.32.3-gke.1512000 |
CRD status.storedVersions tidak valid untuk CRD terkelolaBeberapa CRD yang dikelola GKE mungkin memiliki kolom Masalah ini memengaruhi cluster yang memiliki kedua karakteristik berikut:
Solusi: Solusi yang direkomendasikan adalah menunda upgrade cluster hingga masalah terselesaikan. Atau, jika Anda tahu bahwa cluster Anda berisi versi objek CRD yang tidak didukung, Anda dapat menambahkan versi ini ke kolom |
| Operasi, logging, dan pemantauan | 1.32.2-gke.1652000, 1.31.6-gke.1221000, 1.30.10-gke.1227000 |
|
Metrik tidak ada atau autoscaler workload tidak melakukan penskalaanAnda mungkin mengamati kesenjangan dalam data metrik pada versi yang terpengaruh setelah ukuran cluster bertambah lebih dari lima node. Masalah ini mungkin juga memengaruhi operasi penskalaan otomatis. Masalah ini hanya memengaruhi cluster yang diupgrade ke versi yang terpengaruh. Cluster yang baru dibuat akan berfungsi seperti yang diharapkan. Solusi: Jika Anda terpengaruh, Anda dapat mendowngrade satu versi patch atau mengupgrade ke versi yang lebih baru dan telah diperbaiki. |
| Operasi |
Batas ukuran dan lampiran Google Cloud HyperdiskBiasanya, pod yang tidak dapat dijadwalkan karena batas lampiran volume node akan memicu penyediaan otomatis node baru. Saat menjalankan workload yang menggunakan produk Hyperdisk yang dijadwalkan ke node yang menjalankan VM C3, node auto-provisioning tidak akan terjadi dan pod akan dijadwalkan ke node yang sudah penuh. Workload dijadwalkan ke node meskipun tidak ada lampiran disk yang tersedia. Workload juga gagal dimulai, karena error seperti berikut: AttachVolume.Attach failed for volume "[VOLUME NAME]" : rpc error: code = InvalidArgument desc = Failed to Attach: failed when waiting for zonal op: rpc error: code = InvalidArgument desc = operation operation-[OPERATION NUMBERS] failed (UNSUPPORTED_OPERATION): Maximum hyperdisk-balanced disks count should be less than or equal to [16], Requested : [17] Masalah ini terjadi pada semua produk Hyperdisk di mesin C3. Batas pemasangan Hyperdisk bervariasi menurut jumlah vCPU VM dan produk Hyperdisk. Untuk mengetahui informasi selengkapnya, lihat Batas performa Hyperdisk. Solusi: Produk Google Cloud Hyperdisk memicu penyediaan otomatis pada bentuk VM lainnya. Sebaiknya gunakan bentuk yang hanya mendukung Google Cloud Hyperdisk. |
||
| Operasi | 1.32.3-gke.1927000, 1.32.3-gke.1785000, 1.32.3-gke.1717000, 1.32.3-gke.1440000, 1.32.3-gke.1170000, 1.32.3-gke.1250000, 1.32.3-gke.1671000, 1.32.3-gke.1596000, 1.32.3-gke.1298000 |
gke-metadata-server mengalami OOMKilled di node TPU/GPUPada node TPU GKE (misalnya Solusi: Jika Anda mengamati peristiwa |
|
| Operasi |
|
|
Pengubahan ukuran volume mungkin terhenti karena status NodePendingResize yang menggantung pada PVC.Cluster pada versi 1.32 yang memiliki node pada versi 1.31 atau yang lebih lama akan gagal mengupdate status PersistentVolumeClaim selama pengubahan ukuran. Status yang salah ini mencegah operasi pengubahan ukuran berikutnya dimulai, sehingga secara efektif mencegah pengubahan ukuran lebih lanjut. PVC dalam status ini memiliki kolom Jika PVC dibuat saat cluster Anda berada dalam versi yang terpengaruh, Anda mungkin melihat masalah ini berlanjut setelah cluster diupgrade ke versi yang diketahui telah diperbaiki. Dalam skenario ini, PVC Anda perlu di-patch untuk menghapus kolom Solusi: PVC yang macet karena status menggantung dapat di-patch untuk menghapus status tersebut. Anda dapat menggunakan perintah patch seperti berikut untuk menghapus status menggantung: kubectl patch pvc $PVC_NAME --subresource='status' --type='merge' -p '{"status":{"allocatedResourceStatuses":null}}'kubectl patch pvc $PVC_NAME --subresource='status' --type='merge' -p '{"status":{"allocatedResources":null}}' |
| Operasi |
|
|
Driver PDCSI mungkin mencatat log secara berlebihanCluster GKE pada versi 1.32 tertentu mungkin memunculkan pesan log yang berlebihan dari driver PDCSI. Logging berlebih ini akan menggunakan kuota Write API Cloud Logging. Solusi: Anda dapat mengurangi logging yang berlebihan ini dengan menambahkan filter pengecualian. Untuk mengecualikan pesan log agar tidak diserap ke dalam Cloud Logging, gunakan kueri berikut:
resource.type="k8s_container"
resource.labels.container_name="gce-pd-driver"
(sourceLocation.file="cache.go" OR "Cannot process volume group")
|
| Operasi |
|
|
Pod yang mencoba memasang persistent volume NFS pada node COS yang sebelumnya memiliki pemasangan Hanya Baca (RO) hanya akan dipasang dalam mode ROUntuk GKE versi 1.27 dan yang lebih baru, volume NFS yang menggunakan driver CSI in-tree Kubernetes hanya dapat memasang volume persisten dalam mode RO setelah pemasangan RO sebelumnya pada node yang sama. Solusi: Downgrade node pool ke versi yang lebih lama dari versi yang terpengaruh |
| Operasi |
|
Pod yang mencoba memasang volume persisten NFS pada node Ubuntu tidak akan dapat berjalan.Untuk GKE versi 1.32 dan yang lebih baru, volume NFS yang menggunakan driver CSI in-tree Kubernetes tidak akan dapat memasang volume persisten di node Ubuntu. Jika hal ini terjadi, Anda mungkin melihat pesan error berikut: "MountVolume.SetUp failed for volume 'nfs-storage' : mount failed: exit status 1" Output: Mount failed: mount failed: exit status 127 "Output: chroot: failed to run command 'mount': No such file or directory failed to run command mount on Ubuntu nodes" Selain melihat pesan error ini, Pod yang menggunakan volume ini tidak akan dapat muncul. Solusi: Downgrade node pool ke versi 1.31. |
|
| Operasi | >= 1.28.15-gke.1436000, < 1.28.15-gke.1668000, >= 1.29.12-gke.1040000, < 1.29.13-gke.1028000, >= 1.30.8-gke.1053000, < 1.30.8-gke.1287000, >= 1.31.4-gke.1057000, < 1.31.6-gke.1020000, >= 1.32.0-gke.1281000, < 1.32.1-gke.1369000 |
|
Pod yang menggunakan syscall terkait io_uring mungkin terjebak dalam status Terminating
Pod yang menggunakan syscall terkait io_uring mungkin memasuki status D (disk sleep), yang juga disebut TASK_UNINTERRUPTIBLE, karena bug di kernel Linux. Proses dalam status D tidak dapat diaktifkan oleh sinyal, termasuk
Jika Pod terpengaruh oleh masalah umum ini, containernya mungkin gagal dihentikan secara normal. Dalam log containerd, Anda mungkin melihat pesan berulang yang mirip dengan berikut ini:
atau
Gejala ini menunjukkan proses dalam container yang terjebak dalam status tidur yang tidak dapat diinterupsi (status D), sehingga Pod tidak dapat dihentikan dengan benar.
Workload yang menggunakan io_uring secara langsung, atau yang menggunakan io_uring secara tidak langsung melalui runtime bahasa seperti NodeJS, mungkin terpengaruh oleh masalah umum ini. Workload yang terpengaruh memiliki proses dalam status D (disk sleep) di file Solusi: Upgrade node cluster ke versi yang telah diperbaiki atau yang lebih baru. |
| Operasi | 1.28, 1.29, 1.30, 1.31 |
|
Workload yang menggunakan streaming Image gagal dengan error autentikasiBug dalam fitur streaming Image dapat menyebabkan workload gagal saat serangkaian kondisi tertentu terpenuhi saat container membaca file. Pesan error terkait kegagalan autentikasi mungkin terlihat di log gcfsd.
Untuk memeriksa apakah Anda terpengaruh, telusuri log dengan kueri penelusuran ini:
Adanya error ini menunjukkan bahwa node terpengaruh. Jika Anda terpengaruh oleh masalah ini, Anda dapat mengupgrade node pool ke versi GKE yang telah di-patch. |
| Operasi |
|
|
Peningkatan rasio penghapusan Pod di GKE versi 1.30 dan 1.31
Beberapa versi GKE 1.30 dan GKE 1.31 yang masing-masing menggunakan COS 113 dan COS 117, memiliki kernel yang di-build
dengan opsi
Opsi konfigurasi Anda mungkin tidak selalu melihat tingkat pengosongan Pod yang tidak biasa karena masalah ini bergantung pada pola penggunaan memori workload. Ada risiko yang lebih tinggi bahwa kubelet akan mengeluarkan Pod untuk workload yang belum menetapkan batas memori di kolom resource. Hal ini karena workload mungkin meminta lebih banyak memori daripada yang dilaporkan kubelet sebagai tersedia. Jika Anda melihat penggunaan memori aplikasi yang lebih tinggi setelah mengupgrade ke versi GKE yang disebutkan tanpa perubahan lain, Anda mungkin terpengaruh oleh opsi kernel.
Untuk memeriksa apakah ada tingkat pengeluaran Pod yang tidak biasa, analisis metrik berikut dengan
Metrics Explorer:
Anda dapat menggunakan kueri PromQL berikut. Ganti nilai untuk
max by (pod_name)(max_over_time(kubernetes_io:container_memory_used_bytes{monitored_resource="k8s_container",memory_type="non-evictable",cluster_name="REPLACE_cluster_name",namespace_name="REPLACE_namespace",metadata_system_top_level_controller_type="REPLACE_controller_type",metadata_system_top_level_controller_name="REPLACE_controller_name"}[${__interval}]))
sum by (pod_name)(avg_over_time(kubernetes_io:container_memory_request_bytes{monitored_resource="k8s_container",cluster_name="REPLACE_cluster_name",namespace_name="REPLACE_namespace",metadata_system_top_level_controller_type="REPLACE_controller_type",metadata_system_top_level_controller_name="REPLACE_controller_name"}[${__interval}]))
Jika Anda melihat lonjakan yang tidak biasa dalam penggunaan memori yang melebihi memori yang diminta, workload mungkin akan lebih sering dikeluarkan. SolusiJika Anda tidak dapat mengupgrade ke versi yang diperbaiki dan jika Anda menjalankan di lingkungan GKE tempat Anda dapat men-deploy Pod dengan hak istimewa, Anda dapat menonaktifkan opsi LRU Multi-Gen menggunakan DaemonSet.
Setelah DaemonSet berjalan di semua node pool yang dipilih, perubahan akan segera berlaku dan penghitungan penggunaan memori kubelet akan kembali normal. |
| Operasi | 1.28, 1.29, 1.30, 1.31 |
|
Pod macet dalam status TerminatingBug dalam runtime container (containerd) dapat menyebabkan Pod dan container terjebak dalam status Terminating dengan error yang serupa dengan berikut: OCI runtime exec failed: exec failed: cannot exec in a stopped container: unknown
Jika Anda terkena dampak masalah ini, Anda dapat mengupgrade node ke versi GKE dengan versi containerd yang telah diperbaiki. |
| Operasi |
|
|
Streaming image gagal karena link simbolisBug pada fitur Streaming image dapat menyebabkan container gagal dimulai. Container yang berjalan di node dengan streaming image diaktifkan pada versi GKE tertentu mungkin gagal dibuat dengan error berikut: "CreateContainer in sandbox from runtime service failed" err="rpc error: code = Unknown desc = failed to create containerd container: failed to mount [PATH]: too many levels of symbolic links"
Solusi: Untuk mengatasi masalah ini, upgrade node pool Anda ke versi yang telah diperbaiki (1.35.6-gke.1005000 atau yang lebih baru, atau 1.36.0-gke.2459000 atau yang lebih baru). Jika tidak dapat mengupgrade, Anda dapat memeriksa lapisan kosong atau lapisan duplikat. Jika Anda tidak dapat menghapus lapisan kosong atau lapisan duplikat, nonaktifkan streaming Image. |
| Operasi | 1.27,1.28,1.29 |
|
Streaming image gagal karena file tidak adaBug dalam fitur Streaming image dapat menyebabkan container gagal karena file yang hilang. Container yang berjalan pada node dengan streaming Image yang diaktifkan pada versi berikut mungkin gagal dimulai atau dijalankan dengan error yang menginformasikan bahwa file tertentu tidak ada. Berikut adalah contoh error tersebut:
Jika terpengaruh oleh masalah ini, Anda dapat menonaktifkan streaming Image. |
| Jaringan, Upgrade, dan update | 1,28 |
Error konfigurasi TLS GatewayKami telah mengidentifikasi masalah terkait konfigurasi TLS untuk Gateway di cluster yang menjalankan GKE versi 1.28.4-gke.1083000. Hal ini memengaruhi konfigurasi TLS yang menggunakan SSLCertificate atau CertificateMap. Jika Anda mengupgrade cluster dengan Gateway yang ada, update yang dilakukan pada Gateway akan gagal. Untuk Gateway baru, load balancer tidak akan disediakan. Masalah ini akan diperbaiki dalam versi patch GKE 1.28 mendatang. |
|
| Upgrade dan update | 1.27 | 1.27.8 atau yang lebih baru |
Masalah plugin perangkat GPU
Cluster yang menjalankan GPU dan diupgrade dari 1.26 ke versi patch 1.27
sebelum 1.27.8 mungkin mengalami masalah dengan plugin perangkat GPU
node (
|
| Operasi | 1.27,1.28 |
|
Penskalaan otomatis untuk semua workload berhenti
HorizontalPodAutoscaler (HPA) dan VerticalPodAutoscaler (VPA) mungkin
berhenti menskalakan otomatis semua workload dalam cluster jika cluster tersebut berisi objek HPA
Solusi:
Perbaiki objek HPA
Untuk mengetahui detail selengkapnya tentang cara mengonfigurasi objek HPA |
| Operasi | 1.28,1.29 |
|
Container Threat Detection gagal di-deployContainer Threat Detection mungkin gagal di-deploy pada cluster Autopilot yang menjalankan versi GKE berikut:
|
| Jaringan, Upgrade | 1.27, 1.28, 1.29, 1.30 |
|
Masalah konektivitas untuk Pod
|
| Jaringan | 1.31, 1.32 |
|
Traffic UDP yang rusak antara Pod yang berjalan di node yang samaCluster dengan visibilitas intra-node diaktifkan mungkin mengalami gangguan traffic UDP antara Pod yang berjalan di node yang sama. Masalah ini dipicu saat node cluster GKE diupgrade ke atau dibuat dengan salah satu versi GKE berikut:
Jalur yang terpengaruh adalah traffic UDP Pod-ke-Pod di node yang sama melalui Hostport atau Service. Resolusi Upgrade cluster ke salah satu versi yang telah diperbaiki berikut:
|
| Operasi | 1.29,1.30,1.31 |
|
Operator Ray dan enkripsi database Cloud KMS yang tidak kompatibelBeberapa versi Ray Operator tidak kompatibel dengan enkripsi database Cloud KMS. Solusi sementara: Upgrade bidang kontrol cluster ke versi yang diperbaiki atau yang lebih baru. |
| Upgrade dan update | 1.30, 1.31 |
|
Pod Pengendali Pemeliharaan GPU Terjebak dalam Status CrashLoopBackOffDengan masalah ini, Pod gpu-maintenance-handler terjebak dalam status `CrashLoopBackOff` di node masing-masing. Status ini mencegah label `upcoming maintenance` diterapkan ke node GKE, yang dapat memengaruhi proses pengosongan node dan pengeluaran pod untuk workload.
"Node upcoming maintenance label not applied due to error: Node "gke-yyy-yyy" is invalid: metadata.labels: Invalid value: "-62135596800": a valid label must be an empty string or consist of alphanumeric characters, '-','' or '.', and must start and end with an alphanumeric character (e.g.'MyValue', or 'my_value', or '12345', regex used for validation is '(([A-Za-z0-9][-A-Za-z0-9.]*)?[A-Za-z0-9])?')"
Jika Anda terpengaruh oleh masalah ini, Anda dapat mengatasinya dengan mengupgrade bidang kontrol ke versi GKE yang menyertakan perbaikan. |
| Operasi | 1.33.1-gke.1522000 dan yang lebih baru | 1.33.4-gke.1142000 dan yang lebih baru |
Pod gagal dimulai di node dengan streaming Image yang diaktifkan
Pada node dengan streaming Image yang diaktifkan, workload mungkin gagal dimulai
dengan signature error berikut:
Log port serial node yang terpengaruh juga berisi tanda tangan error berikut:
Adanya dua tanda error ini menunjukkan deadlock di salah satu komponen streaming Image. Kebuntuan ini menghambat Pod untuk berhasil dimulai. Mitigasi: Mulai ulang node untuk mitigasi cepat. Perhatikan bahwa node yang dimulai ulang mungkin masih mengalami deadlock lagi. Untuk mitigasi yang lebih kuat, nonaktifkan streaming Image di node pool dengan menjalankan perintah berikut: gcloud container node-pools update NODE_POOL_NAME --cluster CLUSTER_NAME --no-enable-image-streaming |
| Operasi |
|
|
ComputeClass kustom dengan
|
Langkah berikutnya
Jika Anda tidak dapat menemukan solusi untuk masalah Anda dalam dokumentasi, lihat Mendapatkan dukungan untuk mendapatkan bantuan lebih lanjut, termasuk saran tentang topik berikut:
- Membuka kasus dukungan dengan menghubungi Cloud Customer Care.
- Mendapatkan dukungan dari komunitas dengan
mengajukan pertanyaan di StackOverflow
dan menggunakan tag
google-kubernetes-engineuntuk menelusuri masalah serupa. Anda juga dapat bergabung ke saluran Slack#kubernetes-engineuntuk mendapatkan dukungan komunitas lainnya. - Membuka laporan masalah atau permintaan fitur menggunakan issue tracker publik.