Halaman ini menunjukkan berbagai cara untuk memantau objek RootSync
dan RepoSync
.
Misalnya, Anda mungkin ingin memverifikasi apakah commit terbaru dalam sumber tepercaya
diterapkan ke cluster dan berhasil direkonsiliasi.
Lihat commit yang disinkronkan
Anda dapat memeriksa commit mana yang disinkronkan ke cluster dengan memeriksa kolom .status.sync
dalam 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 objekRootSync
.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 objekRepoSync
.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 dalam kolom RENDERINGCOMMIT
adalah commit yang diproses oleh hydration-controller
. Jika tidak ada rendering yang diperlukan, nilainya akan sama dengan
kolom SOURCECOMMIT
. Nilai dalam kolom SOURCECOMMIT
adalah commit
dari sumber tepercaya yang harus disinkronkan ke cluster. Nilai dalam kolom SYNCCOMMIT
adalah commit yang di-deploy ke cluster. Jika kedua nilai dalam kolom SOURCECOMMIT
dan SYNCCOMMIT
sama, berarti commit yang diharapkan telah di-deploy ke cluster.
Memastikan resource di commit telah direkonsiliasi
Karena ResourceGroups merekam status rekonsiliasi resource terkelola yang dideklarasikan dalam sumber tepercaya, Anda dapat memeriksanya untuk mengonfirmasi apakah resource dalam commit direkonsiliasi.
Objek ResourceGroup memiliki namespace dan nama yang sama
dengan objek RootSync
atau RepoSync
. Misalnya, untuk objek RootSync
dengan
nama root-sync
dalam config-management-system
namespace, objek ResourceGroup yang sesuai juga root-sync
dalam 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 direkonsiliasi, cari hal berikut dalam output:
.status.observedGeneration
sama dengan nilai kolom.metadata.generation
di objek ResourceGroup.- Kondisi
Stalled
dan kondisiReconciling
memilikistatus
sebagai"False"
. - Setiap item di kolom
.status.resourceStatuses
memiliki statusCurrent
.
Lihat error
Objek RootSync
dan RepoSync
menggunakan kolom status
untuk melacak error yang ditemukan
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 objekRootSync
.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 objekRepoSync
.NAMESPACE
: namespace tempat Anda membuat repositori namespace.
Untuk mempelajari subkolom pada kolom status
lebih lanjut, lihat Status objek.
Melihat detail objek
Untuk melihat detail objek RootSync
dan RepoSync
serta menemukan informasi
lebih lanjut tentang potensi error, gunakan perintah kubectl describe
.
Output dari perintah ini mencakup peristiwa, yang dapat sangat membantu untuk men-debug masalah seperti container yang mengalami batasan memori (OOMKilled), kegagalan penjadwalan, atau error penarikan image.
Agar format lebih mudah dibaca, konversikan output ke YAML dengan menambahkan -o yaml
ke perintah berikut. Format ini sangat membantu ketika 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 objekRootSync
.Untuk melihat detail objek
RepoSync
, jalankan perintah berikut:kubectl describe reposync REPO_SYNC_NAME -n NAMESPACE
Ganti kode berikut:
REPO_SYNC_NAME
: nama objekRepoSync
.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 untuk 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 akan dibuat untuk menangkap kumpulan
resource yang diterapkan ke cluster dan menggabungkan statusnya.
Untuk melihat status rekonsiliasi untuk 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 objekRootSync
.Untuk melihat status rekonsiliasi untuk objek
RepoSync
, jalankan perintah berikut:kubectl get resourcegroup.kpt.dev REPO_SYNC_NAME -n NAMESPACE -o yaml
Ganti kode berikut:
REPO_SYNC_NAME
: nama objekRepoSync
.NAMESPACE
: namespace tempat Anda membuat repositori namespace.
Pada output, Anda akan melihat semua status resource ResourceGroup. Misalnya, output berikut menunjukkan bahwa Deployment yang 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 rekonsiler untuk melakukan sinkronisasi. Bagian ini menjelaskan cara melihat log untuk rekonsiler ini. Melihat log dapat membantu saat men-debug masalah dengan
memberikan informasi tambahan tentang progres, peringatan, dan error selain
yang tersedia di status objek RootSync
dan RepoSync
.
Untuk melihat log rekonsiler
RootSync
atauRepoSync
, jalankan perintah berikut:kubectl logs -n config-management-system deployment/RECONCILER_NAME CONTAINER_NAME
Ganti kode berikut:
RECONCILER_NAME
: nama rekonsiliasi objekRootSync
atauRepoSync
.Untuk
RootSync
, nama rekonsilernya adalahroot-reconciler-ROOT_SYNC_NAME
atauroot-reconciler
jika namaRootSync
adalahroot-sync
.Untuk
RepoSync
, nama rekonsilernya adalahns-reconciler-NAMESPACE-REPO_SYNC_NAME-REPO_SYNC_NAME_LENGTH
atauns-reconciler-NAMESPACE
jika namaRepoSync
adalahrepo-sync
, denganNAMESPACE
adalah namespace tempat Anda membuat objekRepoSync
.
CONTAINER_NAME
: nama penampung harus berupa salah satu dari nilai berikut:reconciler
,git-sync
,hydration-controller
,oci-sync
, atauhelm-sync
. Untuk mempelajari penampung ini lebih lanjut, lihat Penampung rekonsiler.
Mengonfigurasi level log rekonsiler RootSync atau RepoSync
Untuk menyertakan informasi lebih lanjut dalam log container, konfigurasikan panjang log. Secara default, sebagian besar penampung memiliki nilai default 0
untuk log
verbositas. Pengecualian untuk hal ini adalah penampung git-sync
dan otel-agent
yang memiliki nilai default 5
.
Saat mengubah panjang log, perlu diingat bahwa meningkatkan panjang log akan mengakibatkan biaya logging yang lebih tinggi karena volume data yang dicatat lebih besar.
Untuk mengubah panjang log, gunakan kolom .spec.override.logLevels
seperti ditunjukkan pada 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 yang berikut:
reconciler
, git-sync
, hydration-controller
, oci-sync
, atau helm-sync
.
Untuk mengonfirmasi 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 panjang
log saat ini. Dalam contoh ini, nilai log verbositas 0 hanya akan mencatat peristiwa penting.