Jika Anda mengalami masalah saat mengupdate Google Distributed Cloud, bagian berikut dapat membantu Anda memecahkan masalah tersebut. Untuk mengetahui informasi selengkapnya tentang setelan yang dapat diperbarui, lihat Yang bisa dan tidak bisa diupdate dalam cluster.
Jika Anda memerlukan bantuan lainnya, hubungi Cloud Customer Care.Waktu tunggu update
Waktu tunggu update dihitung secara dinamis berdasarkan resource yang akan diupdate. Namun, penghitungan tersebut tidak selalu akurat. Jika waktu tunggu update habis, error yang mirip dengan yang berikut ini akan ditampilkan:
Di cluster pengguna:
Failed to update the cluster:...timed out waiting for the condition...
Di cluster admin:
Failed to update the admin cluster:...timed out waiting for the condition...
Error waktu tunggu semacam ini dapat diabaikan dengan aman dan Anda dapat mencoba kembali perintah update. Jika Anda mencoba lagi perintah tersebut dan waktu habis lagi dengan pesan error yang sama, hubungi Cloud Customer Care.
Pembaruan berisi beberapa perubahan
Perintah gkectl update admin
dan gkectl update cluster
tidak mengizinkan pembaruan beberapa setelan dalam satu perintah. Jika konfigurasi berisi operasi diff dengan beberapa setelan yang diubah, dan error yang mirip dengan contoh berikut akan ditampilkan:
Update summary for cluster X:
antiAffinityGroups: enabled to be set to true from false &config.AAGSpec{
- Enabled: false,
+ Enabled: true,
}
user master cpu to be set to 5 from 4 config.NodePoolProps{
Role: "master",
MachineType: "standard-master",
- CPUs: 4,
+ CPUs: 5,
MemoryMB: 8192,
Replicas: 3,
... // 2 identical fields
Labels: nil,
NodeTaints: nil,
- Vsphere: nil,
&config.NodePoolVsphereSpec{Datastore: "lifecycle-workloads1-datastore1"},
+ Vsphere: nil,
BootDiskSizeGB: nil,
OSImageType: "",
... // 5 identical fields
}
Exit with error:
Failed to update the cluster: the update contains multiple changes. Please
update only one feature at a time
Error ini dapat terjadi karena berbagai alasan, termasuk:
- Kesalahan atau kesalahan konfigurasi.
- Anda telah menjalankan
gkectl upgrade
sebelumnya dengan perbedaan konfigurasi, dan berharap perubahan akan diterapkan.gkectl upgrade
tidak menerapkan perbedaan konfigurasi apa pun kecuali nomor versi.
- Anda telah mengedit konfigurasi untuk update fitur lainnya sebelumnya, tetapi lupa menjalankan perintah
gkectl update
.
Jika Anda menemukan perilaku ini, tinjau perbedaan dalam pesan error dan perbarui
setelan yang diperlukan satu per satu dengan beberapa perintah gkectl update
. Untuk membantu
mengidentifikasi perubahan, Anda dapat menggunakan gkectl get-config
untuk
membuat file konfigurasi dari cluster
serta melihat status dan konfigurasi yang ada.
Perubahan yang tidak didukung
Perintah gkectl update cluster
dan gkectl update admin
mengabaikan
perubahan yang tidak didukung, dan menampilkan pesan error yang mirip dengan contoh
berikut:
detected unsupported changes: (-current +desired)
...
- AdvancedNetworking: &true,
+ AdvancedNetworking: &false,
...
, which will be ignored
Jika Anda menemukan perilaku ini, tinjau perbedaan dalam pesan error dan lakukan tindakan berikut:
- Jika perubahan tersebut tidak diinginkan, edit file YAML konfigurasi dan perbarui hanya dengan perubahan yang diinginkan dan benar.
- Pada contoh sebelumnya, jika Anda tidak ingin menonaktifkan
AdvancedNetworking
, tetapkanadvancedNetworking: true
dalam file YAML konfigurasi.
- Pada contoh sebelumnya, jika Anda tidak ingin menonaktifkan
- Jika perubahan tersebut dimaksudkan untuk perubahan, error menunjukkan bahwa perubahan tidak
didukung. Lakukan salah satu tindakan berikut:
- Buat ulang cluster jika perlu.
- Hubungi Dukungan Google.
OS image tidak ada
Perintah gkectl update cluster
dan gkectl update admin
mungkin gagal dengan
kegagalan pemeriksaan preflight OS Images
mirip dengan contoh berikut:
Di cluster pengguna:
- Validation Category: OS Images - [FAILURE] User cluster OS images exist: os images [xxxx] don't exist, please run `gkectl prepare` to upload os images.
Di cluster admin:
- Validation Category: OS Images - [FAILURE] Admin cluster OS images exist: os images [xxxx] don't exist, please run `gkectl prepare` to upload os images.
Error ini dapat terjadi jika OS image dihapus secara tidak terduga di lingkungan vCenter Anda, seperti oleh tugas pembersihan berkala.
Untuk mengimpor ulang impor OS image, jalankan perintah gkectl prepare
, sebagai
berikut:
gkectl prepare \ --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --skip-upload-container-images
Ruang kosong datastore tidak cukup untuk kumpulan node baru
Saat Anda menambahkan kumpulan node baru, perintah gkectl update cluster
mungkin gagal dengan
error pemeriksaan preflight VSphere Datastore FreeSpace
mirip dengan contoh
berikut:
- [FAILURE] VSphere Datastore FreeSpace: vCenter datastore: xxxx insufficient
FreeSpace, requires at least xxx GB
Kegagalan ini menunjukkan bahwa datastore tidak memiliki ruang kosong yang cukup untuk menjalankan kumpulan node baru. Gunakan salah satu opsi berikut untuk membantu menyediakan ruang agar operasi berhasil:
- Kosongkan ruang penyimpanan dari datastore.
- Konfigurasi datastore
nodePools[].vsphere.datastore
yang berbeda untuk kumpulan node.