Membuat dan mengelola node pool

Saat membuat cluster pengguna, Anda harus mengonfigurasi setidaknya satu node pool, yang merupakan grup node yang semuanya memiliki konfigurasi yang sama. Setelah cluster dibuat, Anda dapat menambahkan node pool baru, memperbarui setelan node pool, dan menghapus node pool.

Memilih alat untuk mengelola node pool

Cara Anda membuat, memperbarui, dan menghapus node pool bergantung pada apakah cluster dikelola oleh GKE On-Prem API. Cluster pengguna dikelola oleh GKE On-Prem API jika salah satu hal berikut benar:

• Cluster dibuat di konsol Google Cloud atau menggunakan Google Cloud CLI (gcloud CLI), yang secara otomatis mengonfigurasi GKE On-Prem API untuk mengelola cluster.

• Cluster dibuat menggunakan gkectl, tetapi dikonfigurasi untuk dikelola oleh GKE On-Prem API.

Jika GKE On-Prem API mengelola cluster pengguna, Anda dapat menggunakan konsol atau gcloud CLI untuk mengelola node pool. Jika cluster pengguna tidak dikelola oleh GKE On-Prem API, gunakan gkectl di workstation admin untuk mengelola node pool.

Jika Anda berencana menggunakan gcloud CLI, lakukan hal berikut di komputer yang telah menginstal gcloud CLI:

1. Login dengan Akun Google Anda

   gcloud auth login
   

2. Perbarui komponen:

   gcloud components update
   

Menambahkan node pool

Jika cluster dikelola oleh GKE On-Prem API, Anda dapat menggunakan konsol atau gcloud CLI untuk menambahkan node pool; namun, Anda harus menggunakan gkectl di workstation admin untuk mengonfigurasi setelan node pool berikut:

• Windows untuk jenis OS image
• Datastore vSphere

• Tag vSphere Jika Anda ingin melampirkan tag ke semua VM dalam kumpulan node, akun pengguna vCenter Anda harus memiliki hak istimewa pemberian tag vSphere berikut:

  • Pemberian Tag vSphere.Menetapkan atau Membatalkan Penetapan Tag vSphere
  • Pemberian Tag vSphere.Menetapkan atau Membatalkan Penetapan Tag vSphere pada Objek (vSphere 7)

• Penskalaan otomatis untuk node pool

Sebelum menambahkan kumpulan node lain, pastikan ada cukup alamat IP yang tersedia di cluster.

gkectl

Lakukan tindakan berikut di workstation admin:

1. Di file konfigurasi cluster pengguna, isi bagian nodePools.

   Anda harus menentukan kolom berikut:

   • nodePools.[i].name
   • nodePools[i].cpus
   • nodePools.[i].memoryMB
   • nodePools.[i].replicas

   Kolom berikut bersifat opsional. Jika Anda tidak menyertakan nodePools[i].bootDiskSizeGB atau nodePools[i].osImageType, nilai default akan digunakan.

   • nodePools[i].labels
   • nodePools[i].taints
   • nodePools[i].bootDiskSizeGB
   • nodePools[i].osImageType
   • nodePools[i].vsphere.datastore
   • nodePools[i].vsphere.tags
   Catatan: Jenis Image OS Ubuntu untuk node pool tidak akan digunakan lagi di Google Distributed Cloud versi 1.12 dan tidak didukung di versi 1.13. Sebaiknya ubah node pool Anda sekarang untuk menggunakan Ubuntu Containerd atau COS untuk jenis OS Image.

2. Jalankan perintah berikut:

   gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG dengan jalur file kubeconfig untuk cluster admin Anda.

   • USER_CLUSTER_CONFIG dengan jalur file konfigurasi cluster pengguna Anda.

Contoh konfigurasi

Dalam contoh konfigurasi berikut, ada empat node pool, masing-masing dengan atribut yang berbeda:

• pool-1: hanya atribut minimum yang diperlukan yang ditentukan
• pool-2: menyertakan vsphere.datastore dan vsphere.tags
• pool-3: menyertakan taints dan labels
• pool-4: menyertakan osImageType dan bootDiskSizeGB

nodePools:
- name: pool-1
  cpus: 4
  memoryMB: 8192
  replicas: 5
- name: pool-2
  cpus: 8
  memoryMB: 16384
  replicas: 3
  vsphere:
    datastore: my_datastore
    tags:
    - category: "purpose"
      name: "testing"
- name: pool-3
  cpus: 4
  memoryMB: 8192
  replicas: 5
  taints:
    - key: "example-key"
      effect: NoSchedule
  labels:
    environment: production
    app: nginx
- name: pool-4
  cpus: 4
  memoryMB: 8192
  replicas: 5
  osImageType: cos
  bootDiskSizeGB: 40

Konsol

1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

2. Pilih project Google Cloud tempat cluster pengguna berada.

3. Di daftar cluster, klik nama cluster, lalu klik Lihat detail di panel Details.

4. Klik Add node pool.

5. Konfigurasikan node pool:

   1. Masukkan Nama node pool.
   2. Masukkan jumlah vCPUs untuk setiap node dalam kumpulan (minimum 4 per pekerja cluster pengguna).
   3. Masukkan ukuran memori dalam mebibyte (MiB) untuk setiap node dalam kumpulan (minimum 8.192 MiB per node pekerja cluster pengguna dan harus kelipatan 4).
   4. Di kolom Nodes, masukkan jumlah node dalam kumpulan (minimum 3).

   5. Pilih OS image type: Ubuntu Containerd atau COS.

   6. Masukkan Boot disk size dalam gibibyte (GiB) (default-nya adalah 40 GiB).

6. Di bagian Node pool metadata (optional), jika Anda ingin menambahkan label dan taint Kubernetes, lakukan hal berikut:

   1. Klik + Tambahkan Label Kubernetes. Masukkan Kunci dan Nilai untuk label. Ulangi jika perlu.
   2. Klik + Add Taint. Masukkan Kunci, Nilai, dan Efek untuk taint. Ulangi jika perlu.

7. Klik Create.

8. Konsol Google Cloud menampilkan Status cluster: perubahan sedang berlangsung. Klik Tampilkan Detail untuk melihat Kondisi status resource dan Pesan status.

gcloud CLI

Jalankan perintah berikut untuk membuat node pool:

gcloud container vmware node-pools create NODE_POOL_NAME \
  --cluster=USER_CLUSTER_NAME  \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --image-type=IMAGE_TYPE  \
  --boot-disk-size=BOOT_DISK_SIZE \
  --cpus=vCPUS \
  --memory=MEMORY \
  --replicas=NODES

Ganti kode berikut:

• NODE_POOL_NAME: Nama pilihan Anda untuk node pool. Nama harus:

  • berisi maksimal 40 karakter
  • hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (-)
  • diawali dengan karakter abjad
  • diakhiri dengan karakter alfanumerik

• USER_CLUSTER_NAME: Nama cluster pengguna tempat node pool akan dibuat.

• FLEET_HOST_PROJECT_ID: ID project tempat cluster didaftarkan.

  • LOCATION: Lokasi Google Cloud yang terkait dengan cluster pengguna.

  • IMAGE_TYPE: Jenis OS image yang akan dijalankan di VM dalam node pool. Tetapkan ke salah satu opsi berikut: ubuntu_containerd atau cos.

  • BOOT_DISK_SIZE: Ukuran boot disk dalam kibibyte (GiB) untuk setiap node dalam kumpulan. Minimumnya adalah 40 GiB.

  • vCPUs: Jumlah vCPU untuk setiap node di node pool. Minimumnya adalah 4.

  • MEMORY: Ukuran memori dalam mebibyte (MiB) untuk setiap node dalam kumpulan. Nilai minimumnya adalah 8.192 MiB per node pekerja cluster pengguna dan nilainya harus kelipatan 4.

  • NODES: Jumlah node di node pool. Minimumnya adalah 3.

  Contoh:

  gcloud container vmware node-pools create default-pool \
    --cluster=user-cluster-1  \
    --location=us-west1 \
    --image-type=ubuntu_containerd  \
    --boot-disk-size=40 \
    --cpus=8 \
    --memory=8192 \
    --replicas=5
  

  Secara opsional, Anda dapat menentukan hal berikut:

  • --enable-load-balancer: Hanya relevan untuk load balancer MetalLB. Jika ditentukan, speaker MetalLB akan berjalan di node dalam kumpulan. Setidaknya satu node pool harus diaktifkan untuk load balancer MetalLB.

  • --image=IMAGE: Nama image OS di vCenter.

  • --node-labels=KEY=VALUE,...: Daftar label Kubernetes (pasangan nilai kunci) yang dipisahkan koma dan diterapkan ke setiap node dalam kumpulan.

  • --node-taints=KEY=VALUE:EFFECT,... Daftar taint Kubernetes yang dipisahkan koma yang diterapkan ke setiap node dalam kumpulan. Taint adalah pasangan nilai kunci yang terkait dengan efek. Taint digunakan dengan toleransi untuk penjadwalan Pod. Tentukan salah satu dari berikut ini untuk EFFECT: NoSchedule, PreferNoSchedule, NoExecute.

  Contoh:

  gcloud container vmware node-pools create default-pool \
      --cluster=user-cluster-1  \
      --location=us-west1 \
      --image-type=ubuntu_containerd  \
      --boot-disk-size=40 \
      --cpus=8 \
      --memory=8192 \
      --replicas=5 \
      --node-taints=key1=val1:NoSchedule,key2=val2:NoExecute
  

  Untuk informasi tentang flag opsional lainnya, lihat referensi gcloud.

Memperbarui node pool

Saat Anda meningkatkan jumlah replika, Google Distributed Cloud akan menambahkan jumlah node yang diperlukan ke cluster pengguna, dan saat Anda mengurangi jumlah replika, node akan dihapus. Mengubah jumlah replika untuk node pool tidak akan mengganggu workload. Pastikan Anda memiliki alamat IP yang tersedia jika meningkatkan jumlah replika.

Jika Anda memperbarui kolom node pool lainnya, tindakan ini akan memicu update berkelanjutan di cluster. Dalam update bertahap, Google Distributed Cloud membuat node baru, lalu menghapus node lama. Proses ini diulang hingga semua node lama telah diganti dengan node baru. Proses ini tidak menyebabkan periode nonaktif, tetapi cluster harus memiliki alamat IP tambahan yang tersedia untuk digunakan selama update.

Misalkan node pool akan memiliki N node di akhir update. Kemudian, Anda harus memiliki setidaknya N + 1 alamat IP yang tersedia untuk node dalam kumpulan tersebut. Artinya, jika Anda mengubah ukuran cluster dengan menambahkan node ke satu atau beberapa node pool, Anda harus memiliki setidaknya satu alamat IP lebih banyak daripada jumlah total node yang akan ada di semua node pool cluster pada akhir perubahan ukuran. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi bahwa alamat IP yang tersedia sudah cukup.

Untuk mengupdate node pool di cluster pengguna:

gkectl

1. Ubah nilai untuk kolom yang ingin Anda ubah di bagian nodePools file konfigurasi cluster pengguna.

2. Update cluster:

   gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • ADMIN_CLUSTER_KUBECONFIG dengan jalur file kubeconfig untuk cluster admin Anda.

   • USER_CLUSTER_CONFIG dengan jalur file konfigurasi cluster pengguna Anda.

Memperbarui osImageType yang digunakan oleh node pool

Untuk mengupdate node pool agar menggunakan osImageType yang berbeda, Anda harus menggunakan command line. Untuk mengubah osImageType yang digunakan oleh node pool, perbarui file konfigurasi untuk node pool, seperti yang ditunjukkan pada contoh berikut, dan jalankan gkectl update cluster.

nodePools:
- name: np-1
  cpus: 4
  memoryMB: 8192
  replicas: 3
  osImageType: ubuntu_containerd

Peringatan: Karena dukungan Docker Engine dihapus di Kubernetes 1.24, jenis image OS ubuntu tidak lagi didukung. Anda harus merencanakan untuk mengonversi node pool agar menggunakan jenis image OS ubuntu_containerd atau cos sesegera mungkin.

Konsol

Anda hanya dapat memperbarui kolom berikut menggunakan konsol:

• Jumlah replika
• Memori
• Jumlah vCPU

Untuk memperbarui kolom lain, gunakan gcloud CLI atau gkectl.

1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

2. Pilih project Google Cloud tempat cluster pengguna berada.

3. Di daftar cluster, klik nama cluster, lalu klik Lihat detail di panel Details.

4. Klik tab Nodes.

5. Klik nama node pool yang ingin diubah.

6. Klik Edit di samping kolom yang ingin Anda ubah, lalu klik Selesai.

7. Klik untuk kembali ke halaman sebelumnya.

8. Konsol Google Cloud menampilkan Status cluster: perubahan sedang berlangsung. Klik Tampilkan Detail untuk melihat Kondisi status resource dan Pesan status.

gcloud CLI

1. Secara opsional, cantumkan node pool untuk mendapatkan nama node pool yang ingin Anda perbarui:

   gcloud container vmware node-pools list \
     --cluster=USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=LOCATION
   

2. Jalankan perintah berikut untuk mengupdate node pool:

   gcloud container vmware node-pools update NODE_POOL_NAME \
     --cluster=USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=LOCATION \
     --ATTRIBUTE_TO_UPDATE \
     ...
   

   Ganti kode berikut:

   • NODE_POOL_NAME: Nama node pool yang akan diupdate.

   • USER_CLUSTER_NAME: Nama cluster pengguna yang berisi node pool.

   • LOCATION: Lokasi Google Cloud yang terkait dengan cluster pengguna.

   • ATTRIBUTE_TO_UPDATE: Satu atau beberapa flag untuk memperbarui atribut node pool. Misalnya, untuk mengubah jumlah vCPU dan node dalam kumpulan, jalankan perintah berikut.

   gcloud container vmware node-pools update default-pool \
       --cluster=user-cluster-1  \
       --project=example-project-12345
       --location=us-west1 \
       --cpus=10 \
       --replicas=6
   

   Untuk mengetahui informasi tentang atribut kumpulan node yang dapat Anda perbarui, lihat referensi gcloud.

Memverifikasi perubahan Anda

Untuk memverifikasi bahwa node pool Anda telah dibuat atau diperbarui seperti yang diinginkan, periksa node cluster:

gkectl

Jalankan perintah berikut:

kubectl --kubeconfig USER_CLUSTER_KUBECONFIG get nodes -o wide

Jika Anda perlu mengembalikan perubahan, edit file konfigurasi cluster dan jalankan gkectl update cluster.

Konsol

1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

2. Pilih project Google Cloud tempat cluster pengguna berada.

3. Di daftar cluster, klik nama cluster, lalu klik Lihat detail di panel Details.

4. Klik tab Nodes.

5. Klik nama node pool yang ingin Anda lihat.

gcloud CLI

Jalankan perintah berikut:

gcloud container vmware node-pools describe NODE_POOL_NAME \
  --cluster=USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION

Menghapus node pool

Meskipun Anda dapat menghapus node pool, cluster pengguna harus memiliki setidaknya satu node pool. Menghapus node pool akan langsung menghapus node kumpulan, terlepas dari apakah node tersebut menjalankan beban kerja atau tidak.

Perhatian: Jika cluster dikelola oleh GKE On-Prem API, pastikan untuk menggunakan Konsol Google Cloud atau gcloud CLI untuk menghapus node pool. Menggunakan gketcl untuk menghapus node pool di cluster yang dikelola oleh GKE On-Prem API akan meninggalkan resource yang tidak terpakai di cluster.

Untuk menghapus node pool dari cluster pengguna:

gkectl

1. Pastikan tidak ada beban kerja yang berjalan di node yang terpengaruh.

2. Hapus definisinya dari bagian nodePools file konfigurasi cluster pengguna.

3. Update cluster:

   gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG
   

   Ganti kode berikut:

   • [ADMIN_CLUSTER_KUBECONFIG] dengan jalur file kubeconfig untuk cluster admin Anda.

   • [USER_CLUSTER_CONFIG] dengan jalur file konfigurasi cluster pengguna Anda.

Konsol

1. Pastikan tidak ada beban kerja yang berjalan di node yang terpengaruh.

2. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

3. Pilih project Google Cloud tempat cluster pengguna berada.

4. Di daftar cluster, klik nama cluster, lalu klik Lihat detail di panel Details.

5. Klik tab Nodes.

6. Klik nama node pool yang ingin Anda hapus.

7. Klik Delete.

8. Klik untuk kembali ke halaman sebelumnya.

9. Konsol Google Cloud menampilkan Status cluster: perubahan sedang berlangsung. Klik Tampilkan Detail untuk melihat Kondisi status resource dan Pesan status.

gcloud CLI

1. Secara opsional, cantumkan kumpulan node untuk mendapatkan nama kumpulan node yang ingin Anda hapus:

   gcloud container vmware node-pools list \
     --cluster=USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=LOCATION
   

2. Jalankan perintah berikut untuk menghapus node pool:

   gcloud container vmware node-pools delete NODE_POOL_NAME \
     --cluster=USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=LOCATION
   

   Ganti kode berikut:

   • NODE_POOL_NAME: Nama node pool yang akan dihapus.

   • USER_CLUSTER_NAME: Nama cluster pengguna yang berisi node pool.

   • LOCATION: Lokasi Google Cloud yang terkait dengan cluster pengguna.

Pemecahan masalah

• Secara umum, perintah gkectl update cluster memberikan detail saat gagal. Jika perintah berhasil dan Anda tidak melihat node, Anda dapat memecahkan masalah dengan panduan Mendiagnosis masalah cluster.

• Mungkin ada resource cluster yang tidak memadai seperti kurangnya alamat IP yang tersedia selama pembuatan atau pembaruan node pool. Lihat topik Mengubah ukuran cluster pengguna untuk mengetahui detail tentang cara memverifikasi bahwa alamat IP tersedia.

• Anda juga dapat meninjau artikel Memecahkan masalah update Google Distributed Cloud.

• Tidak akan melanjutkan setelah Creating node MachineDeployment(s) in user cluster….

  Diperlukan waktu beberapa saat untuk membuat atau memperbarui node pool di cluster pengguna Anda. Namun, jika waktu tunggu sangat lama dan Anda mencurigai bahwa ada yang gagal, Anda dapat menjalankan perintah berikut:

  1. Jalankan kubectl get nodes untuk mendapatkan status node Anda.
  2. Untuk node yang belum siap, jalankan kubectl describe node NODE_NAME untuk mendapatkan detail.