Kelola paket

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 paket tercantum dalam objek RootSync atau RepoSync di cluster. Untuk mengetahui informasi yang lebih mendetail tentang objek RootSync dan RepoSync, lihat Arsitektur Sinkronisasi Konfigurasi.

Sebelum memulai

Men-deploy paket

Setelah Anda mendaftarkan cluster ke fleet dan menginstal Config Sync, Anda dapat mengonfigurasi Config Sync untuk men-deploy paket ke cluster dari sumber ketepatan. 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:

  1. Di konsol Google Cloud, buka dasbor Config Sync.

    Buka dasbor Config Sync

  2. Klik Deploy Package.

  3. Di tabel Select clusters for package deployment, pilih cluster tempat Anda ingin men-deploy paket, lalu klik Continue.

  4. Pilih Paket yang dihosting di Git atau Paket yang dihosting di OCI sebagai jenis sumber, lalu klik Lanjutkan.

  5. Di bagian Package details, masukkan Package name, yang mengidentifikasi objek RootSync atau RepoSync.

  6. Di kolom Sync type, pilih Cluster Scope Sync atau Namespace scope 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 Sinkronisasi Konfigurasi.

  7. Di bagian Sumber, selesaikan langkah-langkah berikut:

    • Untuk sumber yang dihosting di repositori Git, masukkan kolom berikut:

      1. Masukkan URL repositori Git yang Anda gunakan sebagai sumber tepercaya sebagai Repository URL.
      2. Opsional: Perbarui kolom Revisi untuk memeriksa apakah Anda tidak menggunakan HEAD default.
      3. Opsional: Perbarui kolom Path jika Anda tidak ingin menyinkronkan dari repositori root.
      4. Opsional: Perbarui kolom Branch jika Anda tidak menggunakan default Cabang main.
    • Untuk sumber yang dihosting dalam gambar OCI, masukkan kolom berikut:

      1. Masukkan URL gambar OCI yang Anda gunakan sebagai sumber kebenaran sebagai Image.
      2. Masukkan jalur direktori yang akan disinkronkan, relatif terhadap direktori root, seperti Direktori.
  8. (Opsional): Luaskan bagian Setelan lanjutan untuk menyelesaikan tindakan berikut:

    1. Pilih Jenis autentikasi. Config Sync membutuhkan akses hanya baca ke sumber tepercaya Anda untuk membaca file konfigurasi dalam sumber dan menerapkannya ke cluster Anda. Kecuali sumber Anda tidak memerlukan otentikasi, seperti repositori publik, pastikan Anda memberikan Config Sync akses hanya baca ke repositori Git Anda, OCI image, atau Helm chart (khusus gcloud CLI). Pilih jenis autentikasi yang sama dengan yang Anda konfigurasi saat menginstal Sinkronisasi Konfigurasi:

      • Tidak ada: Tidak menggunakan autentikasi.
      • SSH: Autentikasi dengan menggunakan pasangan kunci SSH.
      • Cookiefile: Lakukan autentikasi menggunakan cookiefile.
      • Token: Autentikasi dengan menggunakan token akses atau sandi.
      • Google Cloud Repository: Gunakan akun layanan Google untuk mengakses ke 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 ke repositori Cloud Source Repositories.
    2. Masukkan angka dalam detik untuk menetapkan Waktu tunggu sinkronisasi, yang menentukan berapa lama Config Sync menunggu di antara percobaan untuk mengambil dari sumber kebenaran.

    3. Masukkan URL proxy Git untuk proxy HTTPS yang akan digunakan saat berkomunikasi dengan sumber yang terpercaya.

    4. Pilih Hierarchy untuk mengubah Source format.

      Nilai default Tidak terstruktur direkomendasikan pada sebagian besar kasus karena memungkinkan Anda mengatur sumber kebenaran sesuai keinginan Anda.

  9. Klik Deploy Package.

    Anda akan dialihkan ke halaman Packages Config Sync. Setelah beberapa menit, Anda akan melihat Disinkronkan di Status sinkronisasi untuk cluster yang telah Anda konfigurasi.

Mengedit paket

Untuk mengedit paket yang telah Anda deploy, selesaikan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka tab Packages Config Sync.

    Buka Paket

  2. (Opsional): Luaskan menu Filter cepat, lalu pilih filter untuk membantu menemukan paket yang ingin Anda edit.

  3. Luaskan nama paket yang ingin Anda edit, lalu di baris yang berisi nama cluster, klik menu konteks lalu klik Edit paket.

  4. Tinjau dan perbarui setelan paket yang ingin diubah.

  5. Klik Simpan.

Meng-uninstal paket

Untuk meng-uninstal paket dari Konsol Google Cloud, selesaikan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka tab Packages Config Sync.

    Buka Paket

  2. (Opsional): Luaskan menu Filter cepat, lalu pilih filter untuk membantu menemukan paket yang ingin Anda copot instalasinya.

  3. Luaskan nama paket yang ingin Anda uninstal, lalu pada baris yang berisi nama cluster, klik menu konteks lalu klik Uninstal paket.

  4. Pada dialog konfirmasi, pilih apakah hanya akan meng-uninstal objek RootSync atau RepoSync, atau meng-uninstal RootSync atau RepoSync dan semua resource yang dikelola oleh RootSync atau RepoSync.

  5. Ketik pesan konfirmasi, lalu klik Uninstall.

Langkah selanjutnya