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 mengelola 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 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 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:
- 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.
- Jika sebelumnya Anda belum mengonfigurasi Config Sync untuk mengirim metrik ke Cloud Monitoring, berikan izin penulisan metrik. Hal ini diperlukan untuk upgrade otomatis.
Pastikan Config Sync menggunakan versi yang didukung:
console
- Di konsol Google Cloud, buka halaman Config di bagian Features.
- Di tab Setelan, di samping cluster yang versinya ingin Anda upgrade, klik Edit konfigurasi cluster.
- Dari menu drop-down Version, pilih versi yang ingin Anda upgrade.
- Klik Upgrade Config Sync.
gcloud
(Opsional) Jika Anda ingin memeriksa versi Config Sync yang diinstal di cluster sebelum mengupgrade, jalankan perintah berikut:
gcloud beta container fleet config-management
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 upgradeMEMBERSHIP_NAME
: nama keanggotaan fleet yang Anda pilih saat mendaftarkan cluster. Anda dapat menemukan nama langganan dengan menjalankangcloud container fleet memberships list
.
Aktifkan upgrade otomatis Config Sync:
console
Mengaktifkan upgrade otomatis di setiap cluster
Untuk mengaktifkan upgrade otomatis di setiap cluster, selesaikan langkah-langkah berikut:
- Di konsol Google Cloud, buka halaman Config di bagian Features.
- Klik Setelan Sinkronisasi Konfigurasi.
- Pilih Edit konfigurasi cluster untuk cluster yang ingin Anda perbarui.
- Di panel setelan yang muncul, pilih Upgrade otomatis.
- 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:
Di konsol Google Cloud, buka halaman Feature Manager.
Di panel Config Sync, klik Configure.
Untuk mengubah setelan default, klik Sesuaikan setelan armada.
Pada dialog yang muncul, pilih Upgrade otomatis.
Klik Simpan perubahan.
Opsional: Sinkronkan cluster yang ada ke setelan default:
Buka halaman Pengelola Fitur.
Di panel Sinkronisasi Konfigurasi, klik Lihat detail.
Di daftar Cluster dalam fleet, pilih cluster yang ingin Anda sinkronkan.
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:
Update Google Cloud CLI ke versi terbaru:
gcloud components update
Perbarui file
apply spec
Config Sync yang ada untuk menyertakan kolomupgrades: auto
, misalnya:applySpecVersion: 1 spec: upgrades: auto configSync: enabled: true # other fields intentionally omitted
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 dengangcloud container fleet memberships list
.CONFIG_YAML_PATH
: jalur ke fileapply-spec.yaml
Anda.PROJECT_ID
: project ID Anda.
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, kolomStatus
akan menampilkanERROR
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.14.0, upgrade terlebih dahulu ke versi 1.17.0, lalu ke versi 1.20.0.
Untuk mengupgrade Config Sync, selesaikan langkah-langkah berikut:
console
- Di konsol Google Cloud, buka halaman Config di bagian Features.
- Di tab Setelan, di samping cluster yang versi Config Sync-nya ingin Anda upgrade, pilih Edit konfigurasi cluster.
- Dari menu drop-down Version, pilih versi yang ingin Anda upgrade.
- Klik Upgrade Config Sync.
gcloud
(Opsional) Jika Anda ingin memeriksa versi Config Sync yang diinstal di cluster sebelum mengupgrade, jalankan perintah berikut:
gcloud beta container fleet config-management version
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 menjalankangcloud container fleet memberships list
.