Halaman ini menjelaskan cara mengelola paket dengan Config Sync dari konsol Google Cloud.
Paket adalah sekumpulan manifes objek resource Kubernetes yang dikelola di sumber tepercaya dan disinkronkan ke cluster oleh Config Sync. Setiap definisi paket berisi dalam objek RootSync atau RepoSync di cluster. Untuk informasi selengkapnya tentang objek RootSync dan RepoSync, lihat Arsitektur Config Sync.
Sebelum memulai
Men-deploy paket
Setelah mendaftarkan cluster ke fleet dan menginstal Config Sync, Anda dapat mengonfigurasi Config Sync untuk men-deploy paket ke cluster dari sumber tepercaya. Anda dapat men-deploy paket yang sama ke beberapa cluster atau men-deploy paket yang berbeda ke cluster yang berbeda. Anda dapat mengedit paket setelah men-deploy-nya, kecuali untuk beberapa setelan seperti nama paket dan jenis sinkronisasi. Untuk informasi selengkapnya, lihat Mengelola paket.
Untuk men-deploy paket, selesaikan langkah-langkah berikut:
Di konsol Google Cloud, buka dasbor Config Sync.
Klik Deploy Package.
Pada tabel Select clusters for package deployment, pilih cluster yang ingin Anda gunakan untuk men-deploy paket, lalu klik Continue.
Pilih Paket yang dihosting di Git atau Paket yang dihosting di OCI sebagai jenis sumber Anda, lalu klik Continue.
Di bagian Detail paket, masukkan Nama paket, yang mengidentifikasi objek RootSync atau RepoSync.
Di kolom Sync type, pilih Cluster scoped sync atau Namespace scoped sync sebagai jenis sinkronisasi.
Sinkronisasi cakupan cluster membuat objek RootSync dan sinkronisasi cakupan Namespace membuat objek RepoSync. Untuk informasi selengkapnya tentang objek ini, lihat Arsitektur Config Sync.
Di bagian Sumber, selesaikan langkah-langkah berikut:
Untuk sumber yang dihosting di repositori Git, masukkan kolom berikut:
- Masukkan URL repositori Git yang Anda gunakan sebagai sumber tepercaya sebagai URL Repositori.
- Opsional: Perbarui kolom Revision untuk memeriksa apakah Anda tidak menggunakan
HEAD
default. - Opsional: Perbarui kolom Jalur jika Anda tidak ingin menyinkronkan dari repositori root.
- Opsional: Perbarui kolom Branch jika Anda tidak menggunakan cabang
main
default.
Untuk sumber yang dihosting dalam image OCI, masukkan kolom berikut:
- Masukkan URL image OCI yang Anda gunakan sebagai sumber tepercaya sebagai Image.
- Masukkan jalur direktori yang akan disinkronkan, secara relatif terhadap direktori utama, sebagai Direktori.
(Opsional): Luaskan bagian Advanced settings untuk menyelesaikan hal berikut:
Pilih Jenis autentikasi. Config Sync memerlukan akses hanya baca ke sumber tepercaya Anda untuk membaca file konfigurasi di sumber dan menerapkannya ke cluster Anda. Kecuali jika sumber Anda tidak memerlukan autentikasi, seperti repositori publik, pastikan Anda memberikan akses hanya baca ke Config Sync untuk repositori Git, image OCI, atau diagram Helm (khusus gcloud CLI). Pilih jenis autentikasi yang sama dengan yang Anda konfigurasi saat menginstal Config Sync:
- Tidak ada: Tidak menggunakan autentikasi.
- SSH: Lakukan autentikasi menggunakan pasangan kunci SSH.
- Cookiefile: Lakukan autentikasi menggunakan
cookiefile
. - Token: Lakukan autentikasi menggunakan token akses atau sandi.
- Repositori Google Cloud: Menggunakan akun layanan Google untuk mengakses repositori Cloud Source Repositories. Hanya pilih opsi ini jika Workload Identity Federation untuk GKE tidak diaktifkan di cluster Anda.
- Workload Identity: Menggunakan akun layanan Google untuk mengakses repositori Cloud Source Repositories.
Masukkan angka dalam detik untuk menetapkan Waktu tunggu sinkronisasi, yang menentukan waktu tunggu Config Sync di antara upaya untuk mengambil dari sumber tepercaya.
Masukkan URL proxy Git untuk proxy HTTPS yang akan digunakan saat berkomunikasi dengan sumber tepercaya.
Pilih Hierarki untuk mengubah Format sumber.
Nilai default Tidak Terstruktur direkomendasikan dalam sebagian besar kasus karena memungkinkan Anda mengatur sumber tepercaya sesuai keinginan.
Klik Deploy Package.
Anda akan dialihkan ke halaman Paket Config Sync. Setelah beberapa menit, Anda akan melihat Disinkronkan di kolom Status sinkronisasi untuk cluster yang Anda konfigurasikan.
Mengedit paket
Untuk mengedit paket yang telah Anda deploy, selesaikan langkah-langkah berikut:
Di konsol Google Cloud, buka tab Paket Config Sync.
(Opsional): Luaskan menu Filter cepat, lalu pilih filter untuk membantu menemukan paket yang ingin Anda edit.
Luaskan nama paket yang ingin Anda edit, lalu, di baris yang berisi nama cluster, klik menu konteks more_vert, lalu klik edit Edit paket.
Tinjau dan perbarui setelan paket yang ingin Anda ubah.
Klik Simpan.
Meng-uninstal paket
Untuk meng-uninstal paket dari konsol Google Cloud, selesaikan langkah-langkah berikut:
Di konsol Google Cloud, buka tab Paket Config Sync.
(Opsional): Luaskan menu Filter cepat, lalu pilih filter untuk membantu menemukan paket yang ingin Anda uninstal.
Luaskan nama paket yang ingin Anda uninstal, lalu, di baris yang berisi nama cluster, klik menu konteks more_vert, lalu klik delete Uninstal paket.
Pada dialog konfirmasi, pilih apakah akan meng-uninstal hanya objek RootSync atau RepoSync, atau meng-uninstal RootSync atau RepoSync dan semua resource yang dikelola oleh RootSync atau RepoSync.
Ketik pesan konfirmasi, lalu klik Uninstal.
Langkah selanjutnya
- Memantau status Config Sync dan paket
- Menggunakan alat command line
nomos
- Memecahkan masalah Config Sync