Halaman ini mencantumkan masalah umum untuk versi Config Sync yang didukung. Untuk memfilter masalah umum menurut versi produk atau kategori masalah, pilih filter Anda 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 |
---|---|---|---|
Kesehatan komponen | 1.15.0 | 1.17.0 |
Container rekonsiliasi OOMKilled di AutoPilotPada cluster Autopilot, container komponen Config Sync memiliki batas resource yang ditetapkan untuk CPU dan memori. Saat beban, container ini dapat diakhiri 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 memori habis untuk sebagian besar kasus penggunaan. Jika Anda tidak dapat melakukan upgrade, tentukan batas memori yang lebih tinggi menggunakan penggantian resource. |
Kesehatan komponen | 1.15.0 |
Rekonsiliasi tidak dapat dijadwalkanRekonsiler Config Sync memerlukan jumlah resource yang berbeda-beda, bergantung pada konfigurasi RootSync atau RepoSync. Konfigurasi tertentu memerlukan lebih banyak resource daripada yang lain. Jika rekonsiliasi tidak dapat dijadwalkan, itu mungkin karena rekonsiliasi meminta lebih banyak resource daripada yang tersedia di node Anda. Jika Anda menggunakan cluster GKE mode standar, permintaan resource rekonsiliasi akan ditetapkan sangat rendah. Setelan ini dipilih sebagai upaya untuk mengizinkan penjadwalan, meskipun akan menyebabkan throttling dan memperlambat performa, sehingga Config Sync berfungsi pada cluster kecil dan node kecil. Namun, pada Autopilotcluster GKE, permintaan rekonsiliasi ditetapkan lebih tinggi, agar lebih realistis merepresentasikan penggunaan saat menyinkronkan. Solusi: Autopilot GKE atau GKE Standard dengan penyediaan otomatis node yang diaktifkan akan dapat melihat jumlah resource yang diminta dan membuat node dengan ukuran yang tepat untuk memungkinkan penjadwalan. Namun, jika Anda mengonfigurasi node atau ukuran instance node secara manual, Anda mungkin perlu menyesuaikan setelan tersebut untuk mengakomodasi persyaratan resource Pod rekonsiliasi. |
|
Error KNV | 1.15.0 | Kubernetes versi 1.27 |
Error KNV1067 meskipun konfigurasi berhasil diterapkanKarena adanya masalah pada OpenAPI v2, Anda mungkin melihat error Solusi:
Jika cluster Anda menjalankan versi Kubernetes di bawah 1.27, pastikan kolom |
Error KNV | 1.15.0 | 1.16.0 |
Config Sync gagal merekonsiliasi dengan error KNV2002Jika Config Sync tidak dapat merekonsiliasi 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 |
Ekspor 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 telah memperbaiki error dan mengurangi kardinalitas metrik. |
Regresi | 1.15.0 |
Proses ekspor gagal. Izin ditolakSecara default, saat pengelola rekonsiliasi 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 berkonflik dengan dirinya sendiriConfig Sync mungkin terlihat sedang 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 |
Perlawanan Sinkronisasi Konfigurasi dengan resource Config ConnectorConfig Sync mungkin tampak menangani Config Connector pada resource, misalnya StorageBucket.
Masalah ini terjadi jika Anda tidak menetapkan nilai kolom opsional Solusi:
Anda dapat menghindari masalah ini dengan menambahkan kolom |
||
Sumber kebenaran | 1.17.3 |
Kegagalan Autentikasi SSH Git dengan GitHub
Pesan error dari git adalah:
Solusi: Downgrade ke versi 1.17.2 atau gunakan metode autentikasi lain. |
|
Sumber kebenaran | 1.16.1 | 1.16.2 |
Tidak dapat mengevaluasi link sumber secara berkalaConfig Sync dapat mengalami masalah saat rekonsiliasi memulai di tempat yang 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, error ini bersifat sementara, sehingga akan dicatat 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 habis. 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 dimuat ulang pada permintaan pertama dalam waktu lima menit setelah masa berlaku token berakhir. Langkah ini akan mencegah terjadinya 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 yang lebih lama dari 1.17.0, Config Sync memeriksa histori repositori Git lengkap secara default. Hal ini dapat menyebabkan waktu habis permintaan pengambilan 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 Anda masih mengalami masalah ini setelah melakukan upgrade, kemungkinan Source of truth Anda memiliki banyak file, server Git Anda 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 cabangPada Config Sync versi 1.17.0 dan yang lebih baru, Anda mungkin mengalami masalah saat Config Sync gagal mengambil commit terbaru dari HEAD cabang tertentu saat cabang yang sama direferensikan dalam beberapa remote dan tidak sinkron. Misalnya, cabang Contoh berikut menunjukkan tampilan masalah ini: 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 menyetel revisi Git
( |
|
Registry pribadi |
Config Sync tidak menggunakan registry pribadi untuk Deployment rekonsiliasiConfig Sync akan menggantikan image untuk semua Deployment saat registry pribadi dikonfigurasi. Namun, Config Sync tidak menggantikan registry image untuk image dalam Deployment rekonsiliasi. Solusi: Solusi untuk masalah ini adalah dengan mengonfigurasi mirror registry image dalam containerd. |
Langkah selanjutnya
- Jika Anda memerlukan dukungan tambahan, hubungi Cloud Customer Care.