Halaman ini diterjemahkan oleh Cloud Translation API.

Memantau objek RootSync dan RepoSync

Halaman ini menunjukkan berbagai cara untuk memantau objek RootSync dan RepoSync. Misalnya, Anda mungkin ingin memverifikasi apakah commit terbaru Anda di sumber tepercaya diterapkan ke cluster dan berhasil direkonsiliasi.

Melihat commit yang disinkronkan

Anda dapat memeriksa commit mana yang disinkronkan ke cluster dengan memeriksa kolom .status.sync di objek RootSync atau RepoSync.

Untuk melihat commit yang disinkronkan untuk objek RootSync, jalankan perintah berikut:
```
kubectl get rootsync ROOT_SYNC_NAME -n config-management-system
```
Ganti ROOT_SYNC_NAME dengan nama objek RootSync.
Untuk melihat commit yang disinkronkan untuk objek RepoSync, jalankan perintah berikut:
```
kubectl get reposync REPO_SYNC_NAME -n REPO_SYNC_NAMESPACE
```
Ganti kode berikut:
- REPO_SYNC_NAME: nama objek RepoSync.
- REPO_SYNC_NAMESPACE: namespace tempat Anda membuat repositori namespace.

Output untuk perintah ini menunjukkan nilai commit sumber dan commit yang disinkronkan. Misalnya, jika Anda menjalankan perintah untuk RepoSync, Anda akan melihat output yang mirip dengan berikut ini:

NAME        RENDERINGCOMMIT                            SOURCECOMMIT                               SYNCCOMMIT
root-sync   66882815f0ef5517df27e864fb1315e97756ab72   66882815f0ef5517df27e864fb1315e97756ab72   66882815f0ef5517df27e864fb1315e97756ab72

Nilai di kolom RENDERINGCOMMIT adalah commit yang diproses oleh hydration-controller. Jika tidak ada rendering yang diperlukan, nilainya sama dengan kolom SOURCECOMMIT. Nilai di kolom SOURCECOMMIT adalah commit dari sumber tepercaya yang harus disinkronkan ke cluster. Nilai di kolom SYNCCOMMIT adalah commit yang di-deploy ke cluster. Jika dua nilai di kolom SOURCECOMMIT dan SYNCCOMMIT sama, commit yang diharapkan telah di-deploy ke cluster.

Mengonfirmasi bahwa resource dalam commit telah disesuaikan

Karena ResourceGroups mencatat status rekonsiliasi resource terkelola yang dideklarasikan dalam sumber tepercaya, Anda dapat memeriksanya untuk mengonfirmasi apakah resource dalam commit telah direkonsiliasi.

Objek ResourceGroup memiliki namespace dan nama yang sama dengan objek RootSync atau RepoSync. Misalnya, untuk objek RootSync dengan nama root-sync di namespace config-management-system, objek ResourceGroup yang sesuai juga root-sync di namespace config-management-system.

Untuk mendapatkan objek ResourceGroup untuk objek RootSync:

kubectl get resourcegroup ROOT_SYNC_NAME -n config-management-system -o yaml

Untuk mendapatkan objek ResourceGroup untuk objek RepoSync:
```
kubectl get resourcegroup REPO_SYNC_NAME -n REPO_SYNC_NAMESPACE -o yaml
```
Ganti kode berikut:
- ROOT_SYNC_NAME: nama objek ResourceGroup yang ingin Anda cari.
- REPO_SYNC_NAME: nama objek ResourceGroup yang ingin Anda cari.
- REPO_SYNC_NAMESPACE: nama objek ResourceGroup yang ingin Anda cari.

Untuk mengonfirmasi bahwa resource dalam commit telah disesuaikan, cari berikut dalam output:

.status.observedGeneration sama dengan nilai kolom .metadata.generation dalam objek ResourceGroup.
Kondisi Stalled memiliki status sebesar "False".
Setiap item di bagian .status.resourceStatuses memiliki actuation Succeeded, reconcile Succeeded, dan status Current.

Lihat error

Objek RootSync dan RepoSync menggunakan kolom status untuk melacak error yang terjadi saat menyinkronkan konfigurasi dari sumber tepercaya ke cluster.

Untuk melihat status objek RootSync, jalankan perintah berikut:
```
kubectl get rootsync ROOT_SYNC_NAME -n config-management-system -o yaml
```
Ganti ROOT_SYNC_NAME dengan nama objek RootSync.
Untuk melihat status objek RepoSync, jalankan perintah berikut:
```
kubectl get reposync REPO_SYNC_NAME -n NAMESPACE -o yaml
```
Ganti kode berikut:
- REPO_SYNC_NAME: nama objek RepoSync.
- NAMESPACE: namespace tempat Anda membuat repositori namespace.

Untuk mempelajari lebih lanjut sub-kolom di kolom status, lihat Status objek.

Melihat detail objek

Untuk melihat detail objek RootSync dan RepoSync serta menemukan informasi lebih lanjut tentang kemungkinan error, gunakan perintah kubectl describe.

Output perintah ini mencakup peristiwa, yang dapat sangat membantu untuk men-debug masalah seperti container yang menghadapi batasan memori (OOMKilled), kegagalan penjadwalan, atau error penarikan image.

Untuk format yang lebih mudah dibaca, konversi output ke YAML dengan menambahkan -o yaml ke perintah berikut. Format ini sangat membantu saat Anda perlu memeriksa parameter, anotasi, atau spesifikasi resource tertentu.

Untuk melihat detail objek RootSync, jalankan perintah berikut:
```
kubectl describe rootsync ROOT_SYNC_NAME -n config-management-system
```
Ganti ROOT_SYNC_NAME dengan nama objek RootSync.
Untuk melihat detail objek RepoSync, jalankan perintah berikut:
```
kubectl describe reposync REPO_SYNC_NAME -n NAMESPACE
```
Ganti kode berikut:
- REPO_SYNC_NAME: nama objek RepoSync.
- NAMESPACE: namespace tempat Anda membuat repositori namespace.

Melihat apakah resource sudah siap

Untuk mengetahui apakah resource yang disinkronkan ke cluster sudah siap, lihat status rekonsiliasi. Misalnya, melihat status rekonsiliasi dapat menunjukkan apakah Deployment yang disinkronkan siap menyalurkan traffic.

Untuk sumber tepercaya yang disinkronkan ke cluster, status rekonsiliasi semua resource diagregasi dalam resource yang disebut ResourceGroup. Untuk setiap objek RootSync atau RepoSync, ResourceGroup dibuat untuk merekam kumpulan resource yang diterapkan ke cluster dan menggabungkan statusnya.

Untuk melihat status rekonsiliasi objek RootSync, jalankan perintah berikut:
```
kubectl get resourcegroup.kpt.dev ROOT_SYNC_NAME -n config-management-system -o yaml
```
Ganti ROOT_SYNC_NAME dengan nama objek RootSync.
Untuk melihat status rekonsiliasi objek RepoSync, jalankan perintah berikut:
```
kubectl get resourcegroup.kpt.dev REPO_SYNC_NAME -n NAMESPACE -o yaml
```
Ganti kode berikut:
- REPO_SYNC_NAME: nama objek RepoSync.
- NAMESPACE: namespace tempat Anda membuat repositori namespace.

Dalam output, Anda akan melihat semua status resource ResourceGroup. Misalnya, output berikut menunjukkan bahwa Deployment bernama nginx-deployment sudah siap:

resourceStatuses:
- group: apps
  kind: Deployment
  name: nginx-deployment
  namespace: default
  status: Current

Melihat log

Untuk setiap objek RootSync dan RepoSync yang Anda buat, Config Sync akan membuat Deployment rekonsiliasi untuk melakukan sinkronisasi. Bagian ini menjelaskan cara melihat log untuk rekonsiliasi ini. Melihat log dapat membantu saat melakukan debug masalah dengan memberikan informasi tambahan tentang progres, peringatan, dan error di luar yang tersedia dalam status objek RootSync dan RepoSync.

Untuk melihat log rekonsiliasi RootSync atau RepoSync, jalankan perintah berikut:
```
kubectl logs -n config-management-system deployment/RECONCILER_NAME CONTAINER_NAME
```
Ganti kode berikut:
- RECONCILER_NAME: nama rekonsiliasi objek RootSync atau RepoSync.
  - Untuk RootSync, nama rekonsiliasi adalah root-reconciler-ROOT_SYNC_NAME atau root-reconciler jika nama RootSync adalah root-sync.
  - Untuk RepoSync, nama rekonsiliasi adalah ns-reconciler-NAMESPACE-REPO_SYNC_NAME-REPO_SYNC_NAME_LENGTH atau ns-reconciler-NAMESPACE jika nama RepoSync adalah repo-sync, dengan NAMESPACE adalah namespace tempat Anda membuat objek RepoSync.
- CONTAINER_NAME: nama penampung harus berupa salah satu nilai berikut: reconciler, git-sync, hydration-controller, oci-sync, atau helm-sync. Untuk mempelajari lebih lanjut penampung ini, lihat Penampung rekonsiliasi.

Mengonfigurasi level log rekonsiliasi RootSync atau RepoSync

Untuk menyertakan informasi selengkapnya dalam log container, konfigurasi tingkat detail log. Secara default, sebagian besar penampung memiliki nilai default 0 untuk verbositas log. Pengecualian untuk hal ini adalah penampung git-sync dan otel-agent yang memiliki nilai default 5.

Saat mengubah panjang log, perlu diingat bahwa peningkatan panjang log akan menghasilkan biaya logging yang lebih tinggi karena volume data yang direkam lebih besar.

Untuk mengubah panjang informasi log, gunakan kolom .spec.override.logLevels seperti yang ditunjukkan dalam contoh berikut:

apiVersion: configsync.gke.io/v1beta1
kind: RootSync
metadata:
  name: root-sync
  namespace: config-management-system
spec:
  override:
    logLevels:
    - containerName: "reconciler"
      logLevel: 0
    - containerName: "git-sync"
       logLevel: 10

Nilai di kolom containerName harus salah satu dari berikut ini: reconciler, git-sync, hydration-controller, oci-sync, atau helm-sync.

Untuk mengonfirmasi bahwa kejelasan log telah dikonfigurasi, jalankan perintah berikut:

kubectl get deployment.apps/root-reconciler -n config-management-system -o yaml

Panjang log dapat ditemukan sebagai salah satu args dalam spec.template.spec.containers[] dan terlihat seperti -v=0, dengan 0 adalah panjang log saat ini. Dalam contoh ini, nilai kejelasan log 0 hanya akan mencatat peristiwa penting.