Menghapus cluster pengguna

Halaman ini menjelaskan cara menghapus cluster pengguna Google Distributed Cloud. Penghapusan cluster pengguna akan membatalkan pendaftaran cluster dari fleet dan menghapus workload, node pool, node bidang kontrol, serta resource terkait, seperti VM, partisi F5, dan disk data.

Pilih alat untuk menghapus cluster

Cara Anda menghapus cluster pengguna bergantung pada apakah cluster tersebut terdaftar di GKE On-Prem API atau tidak. Cluster pengguna akan didaftarkan di GKE On-Prem API jika salah satu kondisi berikut terpenuhi:

  • Cluster tersebut dibuat menggunakan Konsol Google Cloud, Google Cloud CLI (gcloud CLI), atau Terraform, yang otomatis mendaftarkan cluster di GKE On-Prem API. Secara kolektif, aplikasi standar ini disebut sebagai klien GKE On-Prem API.

  • Cluster dibuat menggunakan gkectl, tetapi terdaftar di GKE On-Prem API.

Jika cluster didaftarkan di GKE On-Prem API, gunakan klien GKE On-Prem API untuk menghapus cluster. Jika cluster tidak terdaftar di GKE On-Prem API, gunakan gkectl di workstation admin untuk menghapus cluster.

Untuk menemukan semua cluster pengguna yang terdaftar di GKE On-Prem API dalam project tertentu, jalankan perintah berikut:

gcloud container vmware clusters list \
    --project=PROJECT_ID \
    --location=-

Saat Anda menetapkan --location=-, artinya Anda mencantumkan semua cluster di semua region. Jika perlu menentukan cakupan dalam daftar, Anda dapat menetapkan --location ke region tertentu.

Jika tercantum, cluster akan didaftarkan di GKE On-Prem API. Jika Anda bukan pemilik project, minimal, Anda harus diberi peran Identity and Access Management roles/gkeonprem.admin di project untuk menghapus cluster terdaftar. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, lihat peran GKE On-Prem API dalam dokumentasi IAM.

Menghapus workload stateful

Sebelum menghapus cluster, hapus workload stateful, PVC, dan PV Anda dengan menjalankan kubectl delete.

Menghapus cluster pengguna

Gkectl

Anda dapat menggunakan gkectl untuk menghapus cluster yang tidak terdaftar di GKE On-Prem API. Jika aturan proxy dan firewall organisasi Anda mengizinkan traffic mencapai gkeonprem.googleapis.com dan gkeonprem.mtls.googleapis.com (nama layanan untuk GKE On-Prem API), gkectl akan dapat menghapus cluster terdaftar.

Jalankan perintah berikut di workstation admin untuk menghapus cluster:

gkectl delete cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --cluster CLUSTER_NAME

dengan

  • ADMIN_CLUSTER_KUBECONFIG adalah jalur ke file kubeconfig cluster admin.
  • CLUSTER_NAME adalah nama cluster pengguna yang ingin Anda hapus.

Jika penghapusan gagal dengan pesan yang mirip dengan pesan berikut:

Exit with error:
...
failed to unenroll user cluster CLUSTER_NAME
failed to create GKE On-Prem API client

Artinya, cluster sudah terdaftar, tetapi gkectl tidak dapat menjangkau GKE On-Prem API. Dalam hal ini, hal termudah untuk dilakukan adalah menggunakan klien GKE On-Prem API untuk menghapus cluster.

Jika penghapusan cluster pengguna gagal di tengah jalan, Anda dapat menjalankan gkectl dengan tanda --force untuk mengabaikan error setengah dan melanjutkan penghapusan.

gkectl delete cluster \
--kubeconfig ADMIN_CLUSTER_KUBECONFIG \
--cluster CLUSTER_NAME \
--force

Jika Anda menggunakan load balancer yang dipaketkan Seesaw, hapus load balancer.

Konsol

Jika cluster pengguna dikelola oleh GKE On-Prem API, lakukan langkah-langkah berikut untuk menghapus cluster:

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

    Buka cluster GKE

  2. Pilih project Google Cloud tempat cluster pengguna berada.

  3. Dalam daftar cluster, cari cluster yang ingin dihapus. Jika Type adalah external, hal ini menunjukkan bahwa cluster dibuat menggunakan gkectl dan tidak didaftarkan di GKE On-Prem API. Dalam hal ini, ikuti langkah-langkah di tab gkectl untuk menghapus cluster.

    Jika ikon di kolom Status menunjukkan masalah, ikuti langkah-langkah di tab gcloud CLI untuk menghapus cluster. Anda harus menambahkan flag --ignore-errors ke perintah delete.

  4. Klik nama cluster yang ingin dihapus.

  5. Di panel Details, di dekat bagian atas jendela, klik Delete.

  6. Saat diminta untuk mengonfirmasi, masukkan nama cluster dan klik Hapus.

gcloud CLI

Jika cluster pengguna dikelola oleh GKE On-Prem API, lakukan hal berikut di komputer yang telah menginstal gcloud CLI:

  1. Perbarui komponen:

    gcloud components update

  2. Dapatkan daftar cluster untuk membantu memastikan bahwa Anda menentukan nama cluster yang benar dalam perintah delete:

    gcloud container vmware clusters list \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION

    Ganti kode berikut:

    • FLEET_HOST_PROJECT_ID: ID project tempat cluster didaftarkan.

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

    Outputnya mirip dengan hal berikut ini:

    NAME                      LOCATION    VERSION          ADMIN_CLUSTER.            STATE
example-user-cluster-1a   us-west1    1.29.100-gke.248    example-admin-cluster-1   RUNNING

  3. Gunakan perintah berikut untuk menghapus cluster:

    gcloud container vmware clusters delete USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=LOCATION \
  --force \
  --allow-missing

    Ganti kode berikut:

    • USER_CLUSTER_NAME: Nama cluster pengguna yang akan dihapus.

    • FLEET_HOST_PROJECT_ID: ID project tempat cluster didaftarkan.

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

    Flag --force memungkinkan Anda menghapus cluster yang memiliki kumpulan node. Tanpa flag --force, Anda harus menghapus kumpulan node terlebih dahulu, lalu menghapus cluster.

    Flag --allow-missing adalah flag Google API standar. Jika flag ini disertakan, perintah akan menampilkan keberhasilan jika cluster tidak ditemukan.

    Jika perintah menampilkan error yang berisi teks failed connecting to the cluster's control plane, hal ini menunjukkan masalah konektivitas dengan cluster admin, Connect Agent, atau lingkungan lokal.

    • Jika menurut Anda masalah konektivitas bersifat sementara, misalnya karena masalah jaringan, tunggu dan coba lagi perintah tersebut.

    • Jika mencoba ulang perintah terus gagal, lihat Mengumpulkan log Connect Agent untuk memecahkan masalah terkait Connect Agent.

    • Jika Anda mengetahui bahwa cluster admin telah dihapus, atau jika VM untuk admin atau cluster pengguna telah dinonaktifkan atau tidak dapat diakses, sertakan flag --ignore-errors dan coba lagi perintah tersebut.

Untuk mengetahui informasi tentang flag lainnya, baca referensi CLI gcloud.

Membersihkan resource

Jika ada masalah saat Anda menghapus cluster, beberapa resource F5 atau vSphere mungkin tertinggal. Bagian berikut menjelaskan cara membersihkan resource yang tertinggal ini.

Membersihkan VM cluster pengguna di vSphere

Untuk memastikan bahwa VM cluster pengguna sudah dihapus, lakukan langkah-langkah berikut:

  1. Dari menu Navigator sebelah kiri vSphere Web Client, klik menu Hosts and Clusters.

  2. Temukan kumpulan resource untuk cluster admin Anda. Ini adalah nilai vCenter.resourcePool dalam file konfigurasi cluster admin Anda.

  3. Di bagian kumpulan resource, temukan VM yang diawali dengan nama cluster pengguna Anda. Ini adalah node bidang kontrol untuk cluster pengguna Anda. Akan ada satu atau tiga di antaranya, bergantung pada apakah cluster pengguna Anda memiliki bidang kontrol ketersediaan tinggi.

  4. Temukan kumpulan resource untuk cluster pengguna Anda. Ini adalah nilai vCenter.resourcePool dalam file konfigurasi cluster pengguna Anda. Jika file konfigurasi cluster pengguna Anda tidak menentukan kumpulan resource, resource tersebut akan diwariskan dari cluster admin.

  5. Di bawah kumpulan resource, temukan VM yang diawali dengan nama kumpulan node di cluster pengguna Anda. Ini adalah node pekerja di cluster pengguna Anda.

  6. Untuk setiap node bidang kontrol dan setiap node pekerja:

    1. Dari vSphere Web Client, klik kanan VM, lalu pilih Power > Power Off.

    2. Setelah VM dimatikan, klik kanan VM, lalu pilih Delete from Disk.

Membersihkan partisi F5 cluster pengguna

Jika ada entri yang tersisa di partisi cluster pengguna, lakukan langkah-langkah berikut:

  1. Dari konsol F5 BIG-IP, di pojok kanan atas konsol, beralihlah ke partisi cluster pengguna yang ingin Anda bersihkan.
  2. Pilih Local Traffic > Virtual Servers > Virtual Server List.
  3. Pada menu Virtual Servers, hapus semua IP virtual.
  4. Pilih Pools, lalu hapus semua kumpulan.
  5. Pilih Node, lalu hapus semua node.

Setelah Anda menyelesaikan

Setelah cluster dihapus, Anda dapat menghapus kubeconfig cluster pengguna.