Pengantar pemecahan masalah

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

Mengupgrade ke versi yang didukung

Pertimbangkan untuk mengupgrade Config Sync ke versi yang didukung. Mengupgrade sering kali menyelesaikan masalah umum dan memberi Anda akses ke fungsi terbaru. Untuk memastikan 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 menghubungi Cloud Customer Care.

Melihat status Config Sync

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

  • Status penginstalan per cluster
  • Error sinkronisasi (baik membaca dari Git maupun merekonsiliasi perubahan)

Membuat laporan bug

Jika Anda 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 berstempel waktu dengan informasi tentang cluster Kubernetes yang ditetapkan dalam konteks kubectl Anda. File ini juga berisi log dari Config Sync Pods. File ini tidak berisi informasi dari resource yang disinkronkan dengan Config Sync.

Melihat dasbor ringkasan

Dasbor Config Sync memberikan ringkasan status paket yang dikelola Config Sync dan status resource dalam paket ini. Dengan menjelajahi dasbor ini, Anda dapat mendapatkan ringkasan cepat tentang status penginstalan Config Sync dan menemukan paket yang mengalami masalah.

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

    Buka Config

Menggunakan pemantauan dan analisis log

Memantau Sinkronisasi Konfigurasi dan menjelajahi lognya dapat membantu Anda menentukan sumber bug dan lebih memahami perilaku yang tidak terduga.

Memahami metrik Config Sync

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

Memantau objek RootSync dan RepoSync

Saat Anda menginstal Config Sync menggunakan Konsol Google Cloud atau Google Cloud CLI, Config Sync akan 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 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, 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 diambil oleh nomos bugreport saat Pod operator atau rekonsiliator dimulai ulang. Untuk 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 dengan menggunakan perintah kubectl. Perintah ini membantu Anda memahami status setiap objek Config Sync.

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

  • config-management-system adalah namespace yang kita 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 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 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 kali diperbarui oleh Config Sync. Setiap objek terkelola dianotasi dengan hash commit Git saat terakhir kali diubah, dan jalur ke konfigurasi yang berisi perubahan.

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 berguna:

  • 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 dan tercantum di bagian Memecahkan masalah menurut jenis masalah dalam daftar isi mungkin dapat membantu.

Langkah selanjutnya