Upgrade Config Sync

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

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 agar otomatis mengupgrade ke versi yang lebih baru di GKE di cluster Google Cloud.

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

• Overhead pemeliharaan yang lebih rendah: menghindari pemantauan untuk versi Config Sync yang lebih baru dan secara manual mengupgrade Config Sync di seluruh cluster Anda.
• Tetap gunakan versi yang didukung: Google mempertahankan versi terbaru yang didukung di cluster Anda, memastikan Anda tidak menggunakan versi Config Sync yang tidak didukung.
• Keandalan yang ditingkatkan: 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. Gugus yang tidak menggunakan saluran rilis GKE diperlakukan sebagai cluster menggunakan GKE Stabil saluran rilis.

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

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

Tabel berikut menampilkan versi Config Sync saat ini yang tersedia di masing-masing versi saluran rilis:

Saluran rilis	Versi Config Sync
Cepat dan Reguler	1,19
Stabil (atau tanpa saluran)	1.18.3

Mengaktifkan upgrade otomatis

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

Anda hanya dapat mengaktifkan upgrade otomatis di GKE di Cluster Google Cloud dengan GKE Enterprise diaktifkan.

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

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

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

1. Pastikan bahwa cluster GKE Anda terdaftar di saluran rilis. Jika cluster GKE tidak terdaftar di saluran rilis, Config Sync melakukan upgrade otomatis seolah-olah cluster menggunakan saluran rilis GKE Stabil.
2. Jika Anda belum pernah mengonfigurasi Config Sync untuk mengirim metrik ke Cloud Monitoring, memberikan 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 Setelan, di samping cluster yang versinya ingin Anda untuk mengupgrade, klik Edit cluster config.
   3. Dari menu drop-down Versi, pilih versi yang ingin Anda upgrade tempat mesin terhubung.
   4. Klik Upgrade Config Sync.

   gcloud

   1. (Opsional) Jika Anda ingin memeriksa versi Config Sync mana yang diinstal di sebelum mengupgrade, 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. 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 masing-masing 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 Setelan, setelah beberapa saat menit, Anda akan melihat Ya di kolom Upgrade otomatis untuk cluster yang dipilih.

   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 Simpan perubahan.

   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 Anda inginkan untuk menyinkronkan.

      4. Klik Sinkronkan ke setelan fleet, lalu klik Konfirmasi di dialog konfirmasi yang muncul. Operasi ini dapat memerlukan waktu beberapa menit untuk diselesaikan.

   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. Anda dapat menemukan nama dengan gcloud container fleet memberships list.
      • CONFIG_YAML_PATH: jalur ke File apply-spec.yaml.
      • 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 mengaktifkan upgrade otomatis. 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 Anda, lihat Mengubah saluran rilis cluster dokumentasi GKE. Jika 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 diupgrade dari versi terbaru versi yang didukung di saluran rilis asli ke versi terbaru 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. Dengan tersedianya versi yang lebih baru di saluran rilis baru, Config Sync akan otomatis melakukan upgrade seperti biasa.
• Jika Anda berhenti berlangganan dari saluran rilis, hal ini tidak akan memengaruhi Config Sync melakukan upgrade otomatis. 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 detail tentang apa saja yang berubah di antara versi. Jika Anda perlu melakukan upgrade dari versi Config Sync yang tidak didukung, Anda harus melakukan upgrade langkah demi langkah tambahan menjadi tidak lebih dari tiga versi minor pada satu waktu. Misalnya, jika versi Config Sync saat ini adalah 1.11.0, upgrade pertama ke versi 1.14.0, dan kemudian ke versi 1.17.0.

Catatan: Jika menggunakan Pengontrol Konfigurasi untuk menginstal dan mengelola Config Sync, Anda tidak harus meningkatkan versi secara manual. Pengontrol Konfigurasi adalah layanan terkelola, jadi Google meningkatkannya 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 Version, pilih 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. Anda dapat menemukan nama keanggotaan dengan menjalankan gcloud container fleet memberships list.