Upgrade Config Sync

Halaman ini menjelaskan cara mengupgrade versi Config Sync yang diinstal di cluster Anda.

Upgrade otomatis Config Sync

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mengonfigurasi Config Sync untuk melakukan upgrade otomatis ke versi yang lebih baru di GKE pada cluster Google Cloud.

Mengaktifkan upgrade otomatis untuk Config Sync akan membantu menyederhanakan pengalaman pengelolaan Anda. Google bertanggung jawab untuk secara otomatis mengupgrade versi Config Sync dan mengawasi siklus proses komponennya. Mengaktifkan upgrade otomatis akan memberi Anda manfaat berikut:

• Overhead pemeliharaan yang lebih rendah: hindari pemantauan untuk versi Config Sync yang lebih baru dan upgrade Config Sync secara manual di seluruh cluster Anda.
• Tetap gunakan versi yang didukung: Google mempertahankan versi terbaru yang didukung di cluster Anda, sehingga memastikan Anda tidak menggunakan versi Config Sync yang tidak didukung.
• Peningkatan keandalan: Google mengelola komponen Config Sync dan merekonsiliasi komponen jika terjadi perubahan.

Versi Config Sync dan saluran rilis GKE

Config Sync memilih versi yang akan di-upgrade berdasarkan saluran rilis cluster Google Kubernetes Engine. Cluster yang tidak menggunakan saluran rilis GKE diperlakukan sebagai cluster menggunakan saluran rilis GKE Stabil.

Anda dapat menggunakan upgrade otomatis untuk memastikan Config Sync diupgrade di cluster secara otomatis. Saat versi baru Config Sync tersedia di saluran rilis, Config Sync akan mengupgrade versi Config Sync yang cocok dengan saluran rilis cluster. Saluran Cepat menawarkan Config Sync versi terbaru segera setelah tersedia. Saluran Reguler menawarkan versi terbaru Config Sync dalam waktu dekat. Saluran Stabil menawarkan versi terbaru Config Sync hanya setelah divalidasi di saluran Cepat dan Reguler.

Untuk informasi selengkapnya tentang saluran rilis, lihat Tentang saluran rilis.

Tabel berikut menunjukkan versi Config Sync saat ini yang tersedia di setiap saluran rilis:

Saluran rilis	Versi Config Sync
Cepat	1.18
Reguler	1,17
Stabil (atau tanpa saluran)	1.16

Mengaktifkan upgrade otomatis

Aktifkan upgrade otomatis untuk memastikan Config Sync diupgrade di cluster secara otomatis di seluruh fleet Anda.

Anda hanya dapat mengaktifkan upgrade otomatis pada GKE di cluster Google Cloud dengan GKE Enterprise yang diaktifkan.

Perhatian: Anda tidak dapat beralih kembali ke upgrade manual setelah mengaktifkan upgrade otomatis.

Untuk menginstal Config Sync dan mengaktifkan upgrade otomatis, ikuti petunjuk di Menginstal Config Sync.

Untuk mengaktifkan upgrade otomatis pada cluster yang telah menginstal Config Sync, selesaikan langkah-langkah berikut:

1. Pastikan cluster GKE Anda terdaftar di saluran rilis. Jika cluster GKE tidak terdaftar di saluran rilis, Config Sync akan otomatis diupgrade seolah-olah cluster tersebut menggunakan saluran rilis GKE Stabil.
2. Jika sebelumnya Anda belum mengonfigurasi Config Sync untuk mengirim metrik ke Cloud Monitoring, berikan izin penulisan metrik. Tindakan ini diperlukan untuk upgrade otomatis.

3. Pastikan Config Sync menggunakan versi yang didukung:

   console

   1. Di konsol Google Cloud, buka halaman Config di bagian Features.

      Buka Konfigurasi

   2. Pada tab Settings, di samping cluster yang versinya ingin Anda upgrade, klik Edit cluster config.
   3. Dari menu drop-down Versi, pilih versi yang ingin Anda upgrade.
   4. Klik Upgrade Config Sync.

   gcloud

   1. (Opsional) Jika ingin memeriksa versi Config Sync yang diinstal di cluster sebelum melakukan upgrade, jalankan perintah berikut:

      gcloud beta container fleet config-management
      

   2. Untuk mengupgrade Config Sync, jalankan perintah berikut:

      gcloud beta container fleet config-management upgrade \
          --version=VERSION \
          --membership=MEMBERSHIP_NAME
      

      Ganti kode berikut:

      • VERSION: versi yang ingin Anda upgrade
      • MEMBERSHIP_NAME: nama keanggotaan fleet yang Anda pilih saat mendaftarkan cluster. Anda dapat menemukan nama keanggotaan dengan menjalankan gcloud container fleet memberships list.

4. Aktifkan upgrade otomatis Config Sync:

   console

   Mengaktifkan upgrade otomatis di setiap cluster

   Untuk mengaktifkan upgrade otomatis pada setiap cluster, selesaikan langkah-langkah berikut:

   1. Di konsol Google Cloud, buka halaman Config di bagian Features.

      Buka Konfigurasi

   2. Klik Config Sync settings.
   3. Pilih Edit cluster config untuk cluster yang ingin Anda perbarui.
   4. Di panel setelan yang muncul, pilih Upgrade otomatis.
   5. Klik Change Config Sync settings. Di tab Settings, setelah beberapa menit, Anda akan melihat Yes di kolom Auto-upgrades untuk cluster yang Anda pilih.

   Mengaktifkan upgrade otomatis sebagai default perangkat

   Untuk mengaktifkan upgrade otomatis di seluruh fleet cluster Anda, selesaikan langkah-langkah berikut:

   1. Di konsol Google Cloud, buka halaman Feature Manager.

      Buka Feature Manager

   2. Di panel Config Sync, klik Configure.

   3. Untuk mengubah setelan default, klik Sesuaikan setelan fleet.

   4. Pada dialog yang muncul, pilih Upgrade otomatis.

   5. Klik Save changes.

   6. Opsional: Sinkronkan cluster yang ada ke setelan default:

      1. Buka halaman Feature Manager.

         Buka Feature Manager

      2. Di panel Config Sync, klik View details.

      3. Di daftar Clusters in the fleet, pilih cluster yang ingin Anda sinkronkan.

      4. Klik Sync to fleet settings dan klik Confirm di dialog konfirmasi yang muncul. Operasi ini dapat memerlukan waktu beberapa menit hingga selesai.

   gcloud

   Untuk mengaktifkan upgrade otomatis pada setiap cluster, selesaikan langkah-langkah berikut:

   1. Update Google Cloud CLI ke versi terbaru:

      gcloud components update
      

   2. Update file apply spec Config Sync yang ada untuk menyertakan kolom upgrades: auto, misalnya:

      applySpecVersion: 1
      spec:
        upgrades: auto
        configSync:
          enabled: true
      # other fields intentionally omitted
      

   3. Terapkan file apply-spec.yaml yang diperbarui:

      gcloud beta container fleet config-management apply \
          --membership=MEMBERSHIP_NAME \
          --config=CONFIG_YAML_PATH \
          --project=PROJECT_ID
      

      Ganti kode berikut:

      • MEMBERSHIP_NAME: nama keanggotaan fleet yang Anda pilih saat mendaftarkan cluster. Anda dapat menemukan namanya dengan gcloud container fleet memberships list.
      • CONFIG_YAML_PATH: jalur ke file apply-spec.yaml Anda.
      • PROJECT_ID: project ID Anda.

   4. Pastikan upgrade otomatis diaktifkan:

      gcloud beta container fleet config-management status \
        --project=PROJECT_ID
      

      Ganti PROJECT_ID dengan ID project Anda.

      Kolom Upgrades menampilkan 'otomatis' untuk cluster yang upgrade otomatisnya diaktifkan. Jika terjadi error saat mengaktifkan upgrade otomatis, kolom Status akan menampilkan ERROR dengan pesan error mendetail.

Mengubah saluran rilis

Untuk mengetahui informasi cara mengubah saluran rilis cluster, lihat Mengubah saluran rilis cluster di dokumentasi GKE. Jika telah mengaktifkan upgrade otomatis untuk Config Sync, Anda harus mempertimbangkan hal berikut saat mengubah saluran rilis:

• Jika Anda mengubah saluran rilis ke saluran yang kurang stabil (misalnya, dari Stabil ke Cepat), Config Sync akan otomatis mengupgrade dari versi terbaru yang didukung di saluran rilis asli ke versi terbaru yang didukung di saluran rilis baru.
• Jika Anda mengubah saluran rilis ke saluran yang lebih stabil (misalnya, dari Cepat ke Stabil), Config Sync tidak akan mendowngrade versi. Seiring waktu, versi terbaru yang didukung di saluran rilis asli akan dipromosikan ke saluran rilis baru. Ketika versi yang lebih baru tersedia di saluran rilis baru, Config Sync akan otomatis melakukan upgrade seperti biasa.
• Jika Anda berhenti berlangganan dari saluran rilis, upgrade otomatis Config Sync tidak akan terpengaruh. Versi Config Sync akan diupgrade seolah-olah cluster Anda terdaftar di saluran rilis Stabil.

Mengupgrade Config Sync secara manual

Sebelum mengupgrade Config Sync, periksa catatan rilis untuk mengetahui detail tentang hal yang berubah di antara versi. Jika perlu melakukan upgrade dari versi Config Sync yang tidak didukung, Anda harus melakukan upgrade langkah demi langkah dengan penambahan tidak lebih dari tiga versi minor sekaligus. Misalnya, jika versi Config Sync saat ini adalah 1.10.0, lanjutkan untuk mengupgrade ke versi 1.13.0, lalu ke versi 1.16.0.

Catatan: Jika menggunakan Pengontrol Konfigurasi untuk menginstal dan mengelola Config Sync, Anda tidak perlu mengupgrade secara manual. Pengontrol Konfigurasi adalah layanan terkelola, jadi Google mengupgradenya secara otomatis. Untuk mengetahui detail tentang perubahan Pengontrol Konfigurasi, lihat catatan rilis Pengontrol Konfigurasi.

Untuk mengupgrade Config Sync, selesaikan langkah-langkah berikut:

console

1. Di konsol Google Cloud, buka halaman Config di bagian Features.

   Buka Konfigurasi

2. Pada tab Settings, di samping cluster yang versi Config Syncnya ingin Anda upgrade, pilih Edit cluster config.
3. Dari menu drop-down Versi, pilih versi yang ingin Anda upgrade.
4. Klik Upgrade Config Sync.

gcloud

1. (Opsional) Jika Anda ingin memeriksa versi Config Sync yang diinstal di cluster sebelum melakukan upgrade, jalankan perintah berikut:

   gcloud beta container fleet config-management version
   

2. Jalankan perintah berikut:

   gcloud beta container fleet config-management upgrade \
       --version=VERSION \
       --membership=MEMBERSHIP_NAME
   

   Ganti kode berikut:

   • VERSION: versi yang ingin Anda upgrade.
   • MEMBERSHIP_NAME: nama keanggotaan fleet yang Anda pilih saat mendaftarkan cluster. Anda dapat menemukan nama keanggotaan dengan menjalankan gcloud container fleet memberships list.