Mengupgrade Config Sync

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

Mengupgrade Config Sync secara otomatis

Anda dapat mengonfigurasi Config Sync untuk mengupgrade secara otomatis ke versi yang lebih baru di cluster GKE di Google Cloud.

Mengaktifkan upgrade otomatis untuk Config Sync membantu menyederhanakan pengalaman pengelolaan Anda. Google bertanggung jawab untuk mengupgrade versi Config Sync secara otomatis 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 menggunakan versi yang didukung: Google mempertahankan versi terbaru yang didukung di cluster Anda, sehingga memastikan Anda tidak menggunakan Config Sync versi yang tidak didukung.
  • Keandalan yang meningkat: Google mengelola komponen Config Sync dan menyelesaikan perbedaan komponen jika ada perubahan.

Versi Config Sync dan saluran rilis GKE

Config Sync memilih versi yang akan diupgrade berdasarkan saluran rilis cluster Google Kubernetes Engine. Cluster yang tidak menggunakan saluran rilis GKE diperlakukan sebagai cluster yang 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 Config Sync versi terbaru dalam waktu dekat. Saluran Stabil hanya menawarkan Config Sync versi terbaru 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 dan Reguler

1,19

Stabil (atau tidak ada saluran)

1.18.3

Mengaktifkan upgrade otomatis

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

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

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

Untuk mengaktifkan upgrade otomatis di cluster yang sudah 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 menggunakan saluran rilis GKE Stabil.
  2. Jika sebelumnya Anda belum mengonfigurasi Config Sync untuk mengirim metrik ke Cloud Monitoring, berikan izin penulisan metrik. Hal 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 Config

    2. Di tab Setelan, di samping cluster yang versinya ingin Anda upgrade, klik Edit konfigurasi cluster.
    3. Dari menu drop-down Version, 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 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 dapat menemukan nama langganan dengan menjalankan gcloud container fleet memberships list.
  4. Aktifkan upgrade otomatis Config Sync:

    console

    Mengaktifkan upgrade otomatis di setiap cluster

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

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

      Buka Config

    2. Klik Setelan Sinkronisasi Konfigurasi.
    3. Pilih Edit konfigurasi cluster untuk cluster yang ingin Anda perbarui.
    4. Di panel setelan yang muncul, pilih Upgrade otomatis.
    5. Klik Ubah setelan Sinkronisasi Konfigurasi. Di tab Setelan, setelah beberapa menit, Anda akan melihat Ya di kolom Upgrade otomatis untuk cluster yang Anda pilih.

    Mengaktifkan upgrade otomatis sebagai default armada

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

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

      Buka Pengelola Fitur

    2. Di panel Config Sync, klik Configure.

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

    4. Pada dialog yang muncul, pilih Upgrade otomatis.

    5. Klik Simpan perubahan.

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

      1. Buka halaman Pengelola Fitur.

        Buka Pengelola Fitur

      2. Di panel Config Sync, klik Lihat detail.

      3. Di daftar Cluster dalam fleet, pilih cluster yang ingin Anda sinkronkan.

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

    gcloud

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

    1. Update Google Cloud CLI ke versi terbaru:

      gcloud components update
      
    2. Perbarui 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 nama 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 'auto' untuk cluster dengan upgrade otomatis yang diaktifkan. Jika terjadi error saat mengaktifkan upgrade otomatis, kolom Status akan menampilkan ERROR dengan pesan error mendetail.

Mengubah saluran rilis

Untuk informasi tentang cara mengubah saluran rilis cluster, lihat Mengubah saluran rilis cluster dalam dokumentasi GKE. Jika Anda 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. Saat versi yang lebih baru tersedia di saluran rilis baru, Config Sync akan otomatis diupgrade secara normal.
  • Jika Anda berhenti berlangganan dari saluran rilis, hal ini tidak akan memengaruhi upgrade otomatis Config Sync. 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 apa yang berubah di antara versi. Jika perlu mengupgrade 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.11.0, upgrade terlebih dahulu ke versi 1.14.0, lalu ke versi 1.17.0.

Untuk mengupgrade Config Sync, selesaikan langkah-langkah berikut:

console

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

    Buka Config

  2. Di tab Setelan, di samping cluster yang versi Config Sync-nya ingin Anda upgrade, pilih Edit konfigurasi cluster.
  3. Dari menu drop-down Version, 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 mengupgrade, 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 langganan dengan menjalankan gcloud container fleet memberships list.