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 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 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 diperlukan rendering, 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 direkonsiliasi

Karena ResourceGroups merekam status rekonsiliasi resource terkelola yang dideklarasikan di 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 direkonsiliasi, cari hal berikut dalam output:

.status.observedGeneration sama dengan nilai kolom .metadata.generation dalam objek ResourceGroup.
Kondisi Stalled dan kondisi Reconciling memiliki status sebagai "False".
Setiap item di kolom .status.resourceStatuses memiliki status sebagai 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 subkolom di kolom status lebih lanjut, 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 penampung yang menghadapi batasan memori (OOMKilled), kegagalan penjadwalan, atau error pull image.

Untuk format yang lebih mudah dibaca, konversikan 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 digabungkan dalam resource yang disebut ResourceGroup. Untuk setiap objek RootSync atau RepoSync, ResourceGroup dibuat untuk mengambil 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

Lihat log

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

Untuk melihat log bagi rekonsiliator RootSync atau RepoSync, jalankan perintah berikut:
```
kubectl logs -n config-management-system deployment/RECONCILER_NAME CONTAINER_NAME
```
Ganti kode berikut:
- RECONCILER_NAME: nama rekonsiliator objek RootSync atau RepoSync.
  - Untuk RootSync, nama rekonsiliator adalah root-reconciler-ROOT_SYNC_NAME atau root-reconciler jika nama RootSync adalah root-sync.
  - Untuk RepoSync, nama rekonsiliator 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 dari nilai berikut: reconciler, git-sync, hydration-controller, oci-sync, atau helm-sync. Untuk mempelajari penampung ini lebih lanjut, lihat Penampung rekonsiliator.

Mengonfigurasi level log RootSync atau RepoSync reconciler

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

Saat mengubah tingkat perincian log, perlu diingat bahwa meningkatkan tingkat perincian log akan menghasilkan biaya logging yang lebih tinggi karena ada volume data yang lebih besar yang dicatat.

Untuk mengubah panjang informasi dalam 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 berupa salah satu dari berikut: reconciler, git-sync, hydration-controller, oci-sync, atau helm-sync.

Untuk mengonfirmasi bahwa panjang log dikonfigurasi, jalankan perintah berikut:

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

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