Mengupdate cluster

Dokumen ini menunjukkan cara melakukan update cluster yang tidak menyertakan perubahan versi.

Update cluster adalah perubahan pada konfigurasi cluster.

Upgrade cluster adalah kasus khusus update cluster yang menyertakan perubahan pada versi bidang kontrol atau perubahan pada versi kumpulan node. Untuk mengetahui informasi tentang cara melakukan upgrade, lihat Mengupgrade GKE di VMware.

Yang dapat diperbarui

Beberapa setelan dan fitur cluster dapat diperbarui, tetapi fitur dan setelan lainnya tidak dapat diperbarui setelah cluster dibuat. Untuk mengetahui fitur yang dapat diupdate, lihat halaman referensi untuk file konfigurasi cluster admin dan file konfigurasi cluster pengguna. Kolom yang dapat diperbarui ditandai sebagai Dapat diubah, dan kolom yang tidak dapat diperbarui ditandai sebagai Tidak dapat diubah.

Anda juga dapat melihat fitur dan setelan mana yang dapat diupdate dengan menjalankan perintah gkectl.

Untuk melihat apa saja yang dapat diupdate di cluster admin:

gkectl update admin --help

Contoh output:

Update the admin cluster. Only the following updates are supported and they can
only be updated one at a time:
- Enabling/Disabling Vsphere Resource Metrics
- Adding static IPs
- Updating vCenter CA certificate
- Registering Admin Cluster
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling Auto Repair
- Enabling/Disabling Auto Resize for Addon Nodes
- Enabling/Disabling GKE OnPrem API
- Updating OS Image Type
- Enabling/Disabling AntiAffinityGroups
- Update Secrets Encryption Configuration
- [Preview] Enabling/Disabling Cluster Backup
- [Preview] Update Cluster Backup configs

Untuk melihat apa saja yang dapat diupdate di cluster pengguna:

gkectl update cluster --help

Contoh output:

Update a GKE On-Prem cluster. Only the following updates are supported and they
can only be updated one at a time:
- Adding static IPs
- Updating node pool
- Updating user master cpu and memory
- Enabling/Disabling Vsphere Resource Metrics
- Enabling/Disabling vSphere CSI deployment
- Enabling/Disabling Auto Repair
- Enabling/Disabling Cloud Audit Logging
- Enabling/Disabling Stackdriver
- Enabling/Disabling GKE OnPrem API
- Registering User Cluster
- Updating vCenter CA certificate
- Updating MetalLB Address Pools
- Enabling/Disabling Auto Resizing on user master
- Updating NodePoolUpdatePolicy
- Enabling/Disabling AntiAffinityGroups
- [Preview] Enabling/Disabling Node Network Policy
- Updating Secrets Encryption
- Enabling/Disabling DataplaneV2 forwardMode

Memperbarui satu hal dalam satu waktu

Perbarui hanya satu fitur atau setelan dalam satu waktu. Misalnya, Anda ingin memperbarui CPU dan memori master dan Anda juga ingin menonaktifkan perbaikan otomatis.

Kemudian, Anda akan melakukan dua update terpisah: satu untuk CPU dan memori master, dan satu lagi perbaikan otomatis. Pastikan update pertama berhasil sebelum Anda melakukan update kedua.

Prosedur pembaruan

Anda dapat menggunakan gkectl, Konsol Google Cloud, atau Google Cloud CLI untuk melakukan pembaruan pada cluster pengguna. Jika membuat cluster pengguna menggunakan Terraform, Anda dapat menggunakan Terraform untuk mengupdate cluster. Dalam hampir semua kasus, Anda harus menggunakan gkectl untuk mengupdate cluster admin.

Contoh berikut menunjukkan cara mengupdate cluster.

Gkectl

Perintah gkectl update menggunakan salah satu bentuk berikut:

gkectl update credentials - Gunakan ini untuk memperbarui kredensial cluster.
gkectl update admin - Jalankan perintah ini setelah Anda membuat perubahan di file konfigurasi cluster admin.
gkectl update cluster - Jalankan perintah ini setelah Anda membuat perubahan di file konfigurasi cluster pengguna.

Contoh cluster Admin (`gkectl update admin`)

Misalnya Anda ingin mengubah nilai gkeOnPremAPI.enabled dari false menjadi true di cluster admin. Pertama, edit file konfigurasi cluster admin, lalu tetapkan nilainya ke true:

gkeOnPremAPI:
  enabled: true

Kemudian, update cluster admin:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

Ganti kode berikut:

ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin
ADMIN_CLUSTER_CONFIG: jalur file konfigurasi cluster admin

Contoh cluster pengguna (`gkectl update cluster`)

Misalnya Anda ingin mengubah nilai stackdriver.vSphereDisableResourceMetrics dari false menjadi true di cluster pengguna. Pertama-tama, edit file konfigurasi cluster pengguna dan tetapkan nilainya ke true:

stackdriver:
  disableVsphereResourceMetrics: true

Kemudian, update cluster pengguna:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

Ganti kode berikut:

ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin
USER_CLUSTER_CONFIG: jalur file konfigurasi cluster pengguna

Contoh cluster pengguna (`gkectl update credentials`)

Misalnya Anda ingin mengubah kredensial yang digunakan cluster pengguna untuk memanggil Server vCenter.

File konfigurasi cluster pengguna memiliki kolom vCenter.credentials.fileRef.path yang mengarah ke file konfigurasi kredensial. Di file konfigurasi kredensial, perbarui nilai username dan password. Contoh:

items:
- name: "vcenter-creds"
  username: "new-vcenter-account"
  password: "U$icUKEW#INE"

Kemudian, perbarui kredensial:

gkectl update credentials vsphere \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Ganti kode berikut:

USER_CLUSTER_CONFIG: jalur file konfigurasi cluster pengguna
ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin

Konsol

Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

Buka cluster GKE
Pilih project Google Cloud, lalu pilih cluster yang ingin Anda update.
Di panel Details, klik More details.
Kolom yang dapat diperbarui di Konsol Google Cloud memiliki ikon pensil. Klik salah satu ikon pensil. Di kotak yang terbuka, ubah nilai kolom sesuai keinginan, lalu klik SELESAI.
Di bagian atas halaman, di status progres, klik Tampilkan detail. Tunggu hingga update selesai.

gcloud CLI

Jalankan perintah update yang berlaku. Tentukan hanya flag untuk konfigurasi yang ingin Anda ubah:

Cluster Admin: gcloud container vmware admin-clusters update
Cluster pengguna: gcloud container vmware clusters update
Kumpulan node pada cluster pengguna: gcloud container vmware node-pools update

Memperbarui pengguna admin di cluster pengguna

Setiap server Kubernetes API cluster harus dapat mengizinkan permintaan yang diterimanya. Untuk mengonfigurasi otorisasi, Anda perlu mengonfigurasi kebijakan kontrol akses berbasis peran (RBAC) Kubernetes di setiap cluster. Pengguna admin adalah pengguna yang telah diberi peran cluster-admin di cluster pengguna. Peran ini memberi pengguna akses administratif penuh ke cluster.

Misalnya Alice dan Bob adalah satu-satunya pengguna admin di cluster pengguna yang disebut cluster-1 di region us-west1. Dan misalkan Alice ingin menambahkan Trent sebagai pengguna admin tambahan. Alice dapat menjalankan perintah berikut:

gcloud container vmware clusters update cluster-1 \
    --project example-project-id-12345 \
    --location us-west1 \
    --admin-users alice@example.com \
    --admin-users bob@example.com \
    --admin-users trent@example.com

Perintah sebelumnya membuat Alice dan Bob tetap dalam daftar pengguna admin dan menambahkan Trent ke daftar pengguna admin. Perhatikan bahwa Alia dan Bobi harus dicantumkan dalam perintah, karena perintah tersebut menimpa daftar pengguna admin saat ini dengan daftar yang ditentukan dalam perintah. Perhatikan juga bahwa setiap flag --admin-users hanya menentukan satu pengguna. Anda tidak dapat menentukan beberapa pengguna dalam satu tanda.

Terraform

Ubah nilai kolom yang berlaku di file konfigurasi Terraform yang Anda gunakan untuk membuat cluster atau kumpulan node. Untuk mengetahui deskripsi kolom yang mendetail, baca dokumentasi referensi Terraform:
- google_gkeonprem_vmware_cluster
- google_gkeonprem_vmware_node_pool
Update konfigurasi dengan menjalankan terraform apply.

Memperbarui pengguna admin di cluster pengguna

Misalnya Alice dan Bobi adalah satu-satunya pengguna admin di cluster pengguna tertentu. Dan misalkan Alice ingin menambahkan Trent sebagai pengguna admin tambahan. Alice dapat menyesuaikan konfigurasi Terraform sebagai berikut, lalu menjalankan terraform apply:

authorization {
  admin_users {
    username = "alice@example.com"
    username = "bob@example.com"
    username = "trent@example.com"
  }
}

Penyesuaian sebelumnya membuat Alice dan Bob tetap berada dalam daftar pengguna admin dan menambahkan Trent ke daftar pengguna admin. Perhatikan bahwa Anita dan Bobi harus tercantum dalam konfigurasi baru, karena perintah terraform apply menimpa daftar pengguna admin saat ini dengan daftar yang ditentukan dalam konfigurasi.

Informasi selengkapnya

Dokumen yang tercantum di bagian ini memberikan detail tambahan tentang cara mengupdate cluster.