Halaman ini mencantumkan masalah umum untuk versi Config Sync yang didukung. Untuk memfilter masalah umum menurut versi produk atau kategori masalah, pilih filter dari menu drop-down berikut.
Pilih versi Config Sync Anda:
Pilih kategori masalah Anda:
Atau, filter masalah umum:
Kategori | Versi yang diidentifikasi | Versi tetap | Masalah dan solusi |
---|---|---|---|
Kondisi komponen | 1.15.0 | 1.17.0 |
Container rekonsiler OOMKilled di AutoPilotDi cluster Autopilot, penampung komponen Config Sync memiliki batas resource yang ditetapkan untuk CPU dan memori. Saat dimuat, container ini dapat dimatikan oleh kubelet atau kernel karena menggunakan terlalu banyak memori. Solusi: Upgrade ke versi 1.17.0 atau yang lebih baru. Pada Config Sync versi 1.17.0, batas CPU dan memori default disesuaikan untuk membantu menghindari error kehabisan memori pada sebagian besar kasus penggunaan. Jika tidak dapat melakukan upgrade, tentukan batas memori yang lebih tinggi menggunakan penggantian resource. |
Kondisi komponen | 1.15.0 |
Rekonsiliasi tidak dapat dijadwalkanRekonsiler Config Sync memerlukan jumlah resource yang berbeda, bergantung pada konfigurasi RootSync atau RepoSync. Konfigurasi tertentu memerlukan lebih banyak resource daripada yang lain. Jika rekonsiler tidak dapat dijadwalkan, hal ini mungkin karena Anda meminta lebih banyak resource daripada yang tersedia di node Anda. Jika Anda menggunakan cluster GKE mode standar, permintaan resource rekonsiler akan ditetapkan sangat rendah. Setelan ini dipilih sebagai upaya untuk memungkinkan penjadwalan, meskipun akan menyebabkan throttling dan performa yang lambat, sehingga Config Sync berfungsi pada cluster kecil dan node kecil. Namun, pada GKE Autopilotclusters, permintaan rekonsiler ditetapkan lebih tinggi, untuk menunjukkan penggunaan secara lebih realistis saat sinkronisasi. Solusi: GKE Autopilot atau GKE Standard dengan penyediaan otomatis node diaktifkan akan dapat melihat jumlah resource yang diminta dan membuat node dengan ukuran yang tepat untuk memungkinkan penjadwalan. Namun, jika mengonfigurasi node atau ukuran instance node secara manual, Anda mungkin perlu menyesuaikan setelan tersebut untuk mengakomodasi persyaratan resource Pod rekonsiler. |
|
Error KNV | 1.15.0 | Kubernetes versi 1.27 |
Error KNV1067 meskipun konfigurasi berhasil diterapkanKarena ada masalah dengan OpenAPI v2, Anda mungkin melihat error Solusi:
Jika cluster Anda menjalankan versi Kubernetes yang lebih lama dari 1.27, pastikan kolom |
Error KNV | 1.15.0 | 1.16.0 |
Config Sync gagal direkonsiliasi dengan error KNV2002Jika Config Sync tidak dapat melakukan rekonsiliasi dengan KNV2002: API discovery failed: APIServer error: unable to retrieve the complete list of server APIs: external.metrics.k8s.io/v1beta1: received empty response for: external.metrics.k8s.io/v1beta1 Solusi: Untuk mengatasi masalah ini, upgrade cluster GKE Anda ke GKE versi 1.28 atau yang lebih baru atau upgrade Config Sync ke versi 1.16.0 atau yang lebih baru. Kedua versi ini berisi perbaikan untuk masalah client-go. |
Regresi | 1.15.0 | 1.17.2 |
Pengeksporan gagal: Label metrik tidak dikenalPada versi 1.15.0, Config Sync menambahkan label Solusi: Upgrade ke versi 1.17.2 atau yang lebih baru. |
Regresi | 1.15.0 | 1.16.1 |
Error kardinalitas dan transformasi metrik tinggiPada versi 1.15.0, Config Sync menambahkan label Solusi: Upgrade ke versi 1.16.1 atau yang lebih baru. Pada versi 1.16.1, kolom jenis dihapus, pemfilteran diperbaiki, dan kolom commit juga difilter dari Cloud Monitoring. Tindakan ini memperbaiki error dan mengurangi kardinalitas metrik. |
Regresi | 1.15.0 |
Ekspor gagal. Izin ditolakSecara default, saat reconciler-manager mendeteksi Kredensial Default Aplikasi, otel-collector akan dikonfigurasi untuk mengekspor metrik ke Prometheus, Cloud Monitoring, dan Monarch. Solusi:
|
|
Regresi | 1.15.0 |
otel-collector mengalami error dengan konfigurasi kustomJika Anda mencoba mengubah atau menghapus salah satu ConfigMaps default, Solusi: Untuk menyesuaikan konfigurasi ekspor metrik, buat ConfigMap bernama |
|
Nomos Cli | 1.15.0 | 1.17.2 |
|
Pemulihan |
Sinkronisasi Konfigurasi Bertarung dengan dirinya sendiriConfig Sync mungkin tampak berada dalam perkelahian pengontrol.
dengan dirinya sendiri. Masalah ini terjadi jika Anda menetapkan nilai default untuk kolom opsional resource di repositori Git. Misalnya, menetapkan Solusi: Hapus kolom dari deklarasi resource. |
||
Pemulihan |
Pertempuran Config Sync dengan resource Config ConnectorConfig Sync mungkin tampak memperjuangkan Config Connector atas sebuah resource, misalnya StorageBucket.
Masalah ini terjadi jika Anda tidak menetapkan nilai kolom opsional dari Solusi:
Anda dapat menghindari masalah ini dengan menambahkan kolom |
||
Sumber kebenaran | 1.16.1 | 1.16.2 |
Tidak dapat mengevaluasi link sumber secara berkalaConfig Sync dapat mengalami masalah saat rekonsiler dimulai, ketika secara berkala tidak dapat mengevaluasi link sumber. Masalah ini terjadi karena
Solusi: Update Config Sync ke versi 1.16.2 atau yang lebih baru. Dalam versi ini, ini adalah error sementara, sehingga dicatat ke dalam log, tetapi tidak dilaporkan sebagai error. |
Sumber kebenaran | 1.15.0 | 1.18.0 |
Kredensial autentikasi yang tidak valid secara berkala untuk Cloud Source RepositoriesConfig Sync dapat mengalami error secara berkala saat masa berlaku token autentikasi untuk Cloud Source Repositories berakhir. Masalah ini disebabkan oleh refresh token yang menunggu hingga masa berlakunya habis sebelum memuat ulang token. Solusi: Update Config Sync ke versi 1.18.0 atau yang lebih baru. Dalam versi ini, token diperbarui pada permintaan pertama dalam waktu lima menit setelah masa berlaku token habis. Hal ini untuk mencegah error kredensial autentikasi yang tidak valid kecuali jika kredensial tersebut benar-benar tidak valid. |
Sumber kebenaran | 1.15.0 | 1.17.0 |
Terjadi error saat menyinkronkan repositori: batas waktu konteks terlampauiPada versi sebelum 1.17.0, Config Sync memeriksa histori repositori Git lengkap secara default. Hal ini dapat menyebabkan waktu permintaan pengambilan habis pada repositori besar dengan banyak commit. Solusi: Upgrade ke versi 1.17.0 atau yang lebih baru. Pada versi 1.17.0 dan yang lebih baru, pengambilan Git dilakukan dengan Jika masih mengalami masalah ini setelah melakukan upgrade, kemungkinan Sumber tepercaya Anda memiliki banyak file, server Git merespons dengan lambat, atau ada masalah jaringan lainnya. |
Menyinkronkan | 1.15.0 |
Jumlah permintaan
|
|
Menyinkronkan | 1.17.0 |
Config Sync gagal mengambil commit terbaru dari cabangDi Config Sync versi 1.17.0 dan yang lebih baru, Anda mungkin mengalami masalah saat Config Sync gagal menarik commit terbaru dari HEAD cabang tertentu ketika cabang yang sama direferensikan di beberapa remote dan tidak sinkron. Misalnya, cabang Contoh berikut menunjukkan seperti apa masalah ini mungkin terlihat: git ls-remote -q [GIT_REPOSITORY_URL] main main^{} 244999b795d4a7890f237ef3c8035d68ad56515d refs/heads/main # the latest commit be2c0aec052e300028d9c6d919787624290505b6 refs/remotes/upstream/main # the commit Config Sync pulls from Solusi: Untuk mengurangi masalah ini, Anda dapat menetapkan revisi Git ( |
Langkah selanjutnya
- Jika Anda memerlukan dukungan tambahan, hubungi Cloud Customer Care.