Jika Anda mengalami kesulitan dengan Config Sync, halaman ini memperkenalkan beberapa alat dan prosedur umum yang dapat membantu Anda mengidentifikasi dan masalah yang Anda alami.
Upgrade ke versi yang didukung
Pertimbangkan untuk mengupgrade Config Sync ke didukung versi. Proses upgrade sering kali menyelesaikan masalah umum dan memberi Anda akses ke fungsionalitas saat ini. Untuk memastikan bahwa Anda selalu menggunakan versi yang didukung, Anda dapat mengaktifkan upgrade otomatis (Pratinjau).
Menggunakan alat command line nomos
Alat command line nomos
menyediakan
insight penting terkait penyiapan Config Sync Anda. Perintah-perintah yang dijelaskan di
bagian berikut sangat membantu
ketika Anda mencoba menentukan
sumber masalah Anda atau kapan Anda perlu menggunakan Cloud Customer Care.
Melihat status Config Sync
Tujuan
nomos status
menyediakan data gabungan dan error untuk membantu Anda
apa yang terjadi dengan penginstalan Config Sync Anda. Hal berikut
informasi tersedia di nomos status
:
- Status penginstalan per cluster
- Error sinkronisasi (baik membaca dari Git maupun merekonsiliasi perubahan)
Buat laporan bug
Jika mengalami masalah dengan Config Sync yang memerlukan bantuan dari
Cloud Customer Care, Anda dapat memberi mereka proses debug yang berharga
menggunakan
Perintah nomos bugreport
.
Perintah ini menghasilkan file ZIP dengan stempel waktu yang berisi informasi tentang Kubernetes
cluster yang ditetapkan dalam konteks kubectl
. File ini juga berisi log dari
Konfigurasi Pod Sinkronisasi. Salinan ini tidak berisi informasi dari sumber daya yang disinkronkan
dengan Config Sync.
Melihat dasbor ringkasan
Tujuan Dasbor Config Sync memberikan ringkasan tentang status paket yang Config Sync mengelola dan status sumber daya dalam paket tersebut. Menjelajahi dasbor dapat membantu Anda mendapatkan gambaran singkat tentang status Penginstalan Config Sync dan temukan paket yang bermasalah.
Untuk mengakses dasbor, di konsol Google Cloud, buka Config di bagian Fitur:
Menggunakan analisis log dan pemantauan
Monitoring Config Sync dan penjelajahan log-nya dapat membantu Anda menentukan sumber {i>bug<i} dan untuk lebih memahami perilaku yang tidak terduga.
Memahami metrik Config Sync
Menggunakan Metrik Sinkronisasi Konfigurasi untuk mendapatkan visibilitas terkait kondisi Config Sync.
Memantau objek RootSync dan RepoSync
Saat Anda menginstal Config Sync menggunakan Konsol Google Cloud atau Google Cloud CLI, Config Sync secara otomatis membuat objek RootSync untuk maksimal. Jika Anda Mengonfigurasi sinkronisasi dari beberapa repositori, Anda dapat membuat objek RepoSync yang berisi informasi konfigurasi tentang repositori namespace.
Memantau objek ini dapat mengungkapkan informasi berharga tentang keadaan Sinkronisasi Konfigurasi. Untuk mempelajari lebih lanjut, lihat Memantau objek RootSync dan RepoSync.
Menggunakan indikator tingkat layanan (SLI)
Untuk menerima notifikasi saat Config Sync tidak berfungsi sebagaimana mestinya, menggunakan SLI Config Sync.
Log kueri
Anda dapat menggunakan Logs Explorer
untuk mengambil, melihat, dan menganalisis data log untuk Config Sync. Log ini dapat
berisi data historis berharga yang tidak diambil oleh nomos bugreport
saat
Pod operator atau rekonsiliasi dimulai ulang. Untuk contoh kueri yang
dapat membantu mendiagnosis masalah Anda, lihat Log Query Config Sync.
Memeriksa resource dengan alat command line kubectl
Config Sync terdiri dari beberapa resource kustom yang dapat Anda kueri
menggunakan perintah kubectl
. Perintah-perintah ini membantu Anda
memahami status masing-masing
objek Config Sync.
Anda perlu mengetahui informasi berikut tentang resource Kubernetes yang Config Sync mengelola:
config-management-system
adalah namespace yang kita gunakan untuk menjalankan semua komponen sistem Config Sync.configmanagement.gke.io
danconfigsync.gke.io
adalah grup API yang untuk semua resource kustom.
Contoh
Bagian berikut menunjukkan cara menggunakan perintah kubectl
untuk memeriksa
Sinkronisasi Konfigurasi.
Mencantumkan resource kustom
Anda bisa mendapatkan daftar lengkap resource kustom dengan menjalankan perintah berikut:
kubectl api-resources | grep -E "configmanagement.gke.io|configsync.gke.io"
Setiap resource kustom dapat dipakai dengan menjalankan perintah berikut:
kubectl get RESOURCE -o yaml.
Ganti
RESOURCE
dengan nama resource yang Anda kueri.Misalnya, {i>output<i} dari perintah berikut memungkinkan Anda memeriksa status Objek RootSync:
kubectl get rootsync -n config-management-system -o yaml
Memeriksa anotasi token objek
Anda mungkin ingin tahu kapan objek Kubernetes terkelola terakhir kali diupdate oleh Sinkronisasi Konfigurasi. Setiap objek terkelola dianotasi dengan hash Git atau melakukan commit saat terakhir diubah, dan jalur ke konfigurasi yang berisi modifikasi.
Misalnya, untuk mendapatkan anotasi ClusterRoleBinding
namespace-readers
, jalankan perintah berikut:
kubectl get clusterrolebinding namespace-readers
Outputnya mirip dengan hal berikut ini:
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
annotations:
configmanagement.gke.io/source-path: cluster/namespace-reader-clusterrolebinding.yaml
configmanagement.gke.io/token: bbb6a1e2f3db692b17201da028daff0d38797771
name: namespace-readers
...
Untuk informasi selengkapnya, lihat label dan anotasi.
Baca dokumentasi pemecahan masalah tambahan
Jika Anda masih mengalami masalah, referensi berikut mungkin membantu:
Jika Anda menerima pesan kesalahan, lihat kesalahan halaman referensi untuk mendapatkan saran tentang menyelesaikan {i>error<i}.
Periksa apakah masalah yang Anda alami disebabkan oleh masalah umum.
Jika Anda mengalami kesulitan dengan area tertentu, salah satu panduan pemecahan masalah yang tercantum di bagian Memecahkan masalah berdasarkan jenis masalah daftar isi mungkin akan membantu.
Langkah selanjutnya
- Jika Anda memerlukan dukungan tambahan, hubungi Cloud Customer Care.