Konten nomos bugreport

Alat command line nomos membantu tugas administratif umum untuk Config Sync, misalnya membuat arsip diagnostik. Output dan tata letak arsip yang tepat dapat berubah dan tidak dianggap sebagai API. Kode untuk nomos tersedia di repositori Config Sync.

Anda bisa mendapatkan informasi serupa dari cluster dengan menjalankan kubectl get atau kubectl logs, tetapi keunggulan nomos bugreport adalah bahwa perintah ini membuat arsip informasi utama tentang sistem Config Sync. Saat Anda menghubungi Google Cloud Dukungan, akan sangat membantu jika Anda memberikan output nomos bugreport.

Anda juga dapat menggunakan output nomos bugreport untuk proses debug atau dukungan internal Anda sendiri.

Struktur file output nomos bugreport terlihat seperti ini:

- raw/
  - cluster/
    - configmanagement/
  - namespaces/
    - config-management-monitoring/
    - config-management-system/
    - gatekeeper-system/
    - resource-group-system/
    - kube-system/
- processed/
  - status.txt
  - version.txt

Informasi yang bisa Anda dapatkan dari nomos bugreport:

  1. Versi Nomos menampilkan versi Config Sync, output nomos version.
  2. Status Nomos menampilkan output status nomos status, misalnya commit mana yang disinkronkan dan error apa pun.
  3. Informasi tentang resource kustom Config Sync:
    1. Untuk resource cakupan cluster seperti ConfigManagement dan ClusterSelector berada di sini: raw/cluster-1/cluster/configmanagement/.
    2. Untuk yang cakupannya namespace, seperti RootSync, RepoSync, dan ResourceGroup, terletak di sini: raw/cluster-1/namespaces/namespace-1.
  4. Resource yang disinkronkan dan dikelola oleh Config Sync:
    1. Jika Anda telah mengaktifkan API RootSync dan RepoSync, informasi ini ada di spesifikasi ResourceGroup. Anda bisa mendapatkan jumlah resource tersebut, serta jenis, namespace, dan namanya.
    2. Jika Anda tidak mengaktifkan RootSync dan RepoSync API serta menentukan kolom git dalam objek ConfigManagement (tidak digunakan lagi), konten lengkap resource ada di ClusterConfigs dan NamespaceConfigs. Anda harus Memigrasikan objek ConfigManagement.
  5. Log semua Pod Config Sync berada di bagian raw/cluster-1/namespaces/pod-namespace-1/pod-name-1/container-name.txt.
  6. Konten lengkap semua Pod Config Sync: di bagian raw/cluster-1/namespaces/pod-namespace-1/pods.txt.
  7. Apakah API RootSync dan RepoSync Config Sync diaktifkan (yaitu, menggunakan mode multi-repo) atau tidak?
    1. Periksa resource ConfigManagement dan jika Anda melihat spec.enableMultiRepo: true, API RootSync dan RepoSync sudah diaktifkan.
    2. Jika Anda melihat komponen seperti RootSync, RepoSync, atau Pod rekonsiliasi, berarti Anda telah mengaktifkan API RootSync dan RepoSync.
    3. Jika Anda melihat komponen seperti Pod git-importer, berarti API RootSync dan RepoSync tidak diaktifkan dan Anda perlu Memigrasikan objek ConfigManagement.