Pengantar pemecahan masalah

Jika Anda mengalami kesulitan dengan Config Sync, halaman ini memperkenalkan beberapa alat dan prosedur umum yang dapat membantu Anda mengidentifikasi dan menyelesaikan masalah yang dialami.

Upgrade ke versi yang didukung

Pertimbangkan untuk mengupgrade Sinkronisasi Konfigurasi ke versi yang didukung. Mengupgrade sering kali dapat menyelesaikan masalah umum dan memberi Anda akses ke fungsi terbaru. Untuk memastikan bahwa Anda selalu menggunakan versi yang didukung, Anda dapat mengaktifkan upgrade otomatis (Pratinjau).

Menggunakan alat command line nomos

Alat command line nomos memberikan insight penting tentang penyiapan Config Sync Anda. Perintah yang dijelaskan di bagian berikut sangat membantu saat Anda mencoba menentukan sumber masalah atau saat Anda perlu bekerja dengan Cloud Customer Care.

Melihat status Config Sync

Perintah nomos status memberi Anda data gabungan dan error untuk membantu Anda memahami apa yang terjadi dengan penginstalan Config Sync. Informasi berikut tersedia dengan nomos status:

  • Status penginstalan per cluster
  • Menyinkronkan error (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 memberikan informasi proses debug yang berharga kepada mereka menggunakan perintah nomos bugreport.

Perintah ini menghasilkan file ZIP dengan stempel waktu yang berisi informasi tentang cluster Kubernetes yang ditetapkan dalam konteks kubectl. File ini juga berisi log dari Pod Config Sync. File ini tidak berisi informasi dari resource yang disinkronkan dengan Config Sync.

Melihat dasbor ringkasan

Dasbor Config Sync memberi Anda ringkasan status paket yang dikelola oleh Config Sync dan status resource dalam paket ini. Dengan menjelajahi dasbor ini, Anda dapat melihat ringkasan singkat status penginstalan Config Sync dan menemukan paket yang mengalami masalah.

  • Untuk mengakses dasbor, di Konsol Google Cloud, buka halaman Config di bagian Features:

    Buka Konfigurasi

Menggunakan pemantauan dan analisis log

Dengan memantau Config Sync dan mempelajari log-nya, Anda dapat menentukan sumber bug dan lebih memahami perilaku yang tidak terduga.

Memahami metrik Config Sync

Gunakan metrik Config Sync untuk mendapatkan visibilitas terkait kondisi Config Sync.

Memantau objek RootSync dan RepoSync

Saat Anda menginstal Config Sync menggunakan Google Cloud Console atau Google Cloud CLI, Config Sync secara otomatis membuat objek RootSync untuk Anda. Saat Mengonfigurasi sinkronisasi dari beberapa repositori, Anda dapat membuat objek RepoSync yang berisi informasi konfigurasi tentang repositori namespace Anda.

Memantau objek ini dapat mengungkapkan informasi berharga tentang status Config Sync. 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, gunakan 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 ditangkap oleh nomos bugreport saat operator atau Pod rekonsiler dimulai ulang. Untuk mengetahui contoh kueri yang mungkin membantu Anda mendiagnosis masalah, lihat Log Sinkronisasi Konfigurasi Kueri.

Memeriksa resource dengan alat command line kubectl

Config Sync terdiri dari beberapa resource kustom yang dapat Anda buat kuerinya menggunakan perintah kubectl. Perintah ini membantu Anda memahami status setiap objek Config Sync.

Anda perlu mengetahui informasi berikut tentang resource Kubernetes yang dikelola oleh Config Sync:

  • config-management-system adalah namespace yang kami gunakan untuk menjalankan semua komponen sistem inti Config Sync.
  • configmanagement.gke.io dan configsync.gke.io adalah grup API yang kita gunakan untuk semua resource kustom.

Contoh

Bagian berikut menunjukkan cara menggunakan perintah kubectl untuk memeriksa Sinkronisasi Konfigurasi.

Mencantumkan resource kustom

  • Anda dapat memperoleh daftar lengkap resource kustom dengan menjalankan perintah berikut:

    kubectl api-resources | grep -E "configmanagement.gke.io|configsync.gke.io"

  • Setiap resource kustom dapat digunakan dengan menjalankan perintah berikut:

    kubectl get RESOURCE -o yaml.

    Ganti RESOURCE dengan nama resource yang ingin Anda kueri.

    Misalnya, output perintah berikut memungkinkan Anda memeriksa status objek RootSync:

    kubectl get rootsync -n config-management-system -o yaml

Memeriksa anotasi token objek

Anda mungkin ingin mengetahui kapan objek Kubernetes terkelola terakhir diperbarui oleh Config Sync. Setiap objek terkelola dianotasi dengan hash commit Git saat terakhir diubah, dan jalur ke konfigurasi yang berisi modifikasi tersebut.

Misalnya, untuk mendapatkan anotasi ClusterRoleBinding bernama 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 dapat membantu:

  • Jika Anda menerima pesan error, lihat halaman referensi error untuk mendapatkan saran tentang cara mengatasi error.

  • Periksa apakah masalah yang Anda alami disebabkan oleh masalah umum.

  • Jika Anda mengalami kesulitan dengan area tertentu, salah satu panduan pemecahan masalah yang ditargetkan yang tercantum di bagian Memecahkan masalah berdasarkan jenis masalah dalam daftar isi mungkin dapat membantu.

Langkah selanjutnya