Pengantar pemecahan masalah

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:

    Buka Konfigurasi

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 dan configsync.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