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, kumpulan node, node bidang kontrol, dan resource terkait, seperti VM, partisi F5, dan disk data.

Memilih alat untuk menghapus cluster

Cara Anda menghapus cluster pengguna bergantung pada apakah cluster terdaftar di GKE On-Prem API. Cluster pengguna terdaftar di GKE On-Prem API jika salah satu dari hal berikut benar:

  • Cluster 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 terdaftar 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=-

Outputnya mirip dengan hal berikut ini:

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

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

Jika tercantum, cluster akan terdaftar di GKE On-Prem API. Jika Anda bukan pemilik project, setidaknya 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 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 menjangkau 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 

di mana

  • 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 berikut ini:

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

Artinya, cluster terdaftar, tetapi gkectl tidak dapat menjangkau GKE On-Prem API. Dalam hal ini, hal termudah yang dapat 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 di tengah jalan dan melanjutkan penghapusan.

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

Jika Anda menghapus cluster yang menggunakan load balancer Seesaw, hapus VM Seesaw. Anda dapat melakukannya dengan menghapus VM Seesaw di antarmuka pengguna vSphere.

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. Di daftar cluster, cari cluster yang ingin dihapus. Jika Type adalah external, ini menunjukkan bahwa cluster dibuat menggunakan gkectl dan tidak terdaftar 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 penghapusan.

  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, lalu klik Hapus.

gcloud CLI

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

  1. Perbarui komponen:

    gcloud components update
    
  2. Gunakan perintah berikut untuk menghapus cluster:

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

    Ganti kode berikut:

    • USER_CLUSTER_NAME: Nama cluster pengguna yang akan dihapus.

    • PROJECT_ID: ID project tempat cluster didaftarkan.

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

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

    Flag --allow-missing adalah flag Google API standar. Jika Anda menyertakan tanda ini, 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, Agen Connect, atau lingkungan lokal.

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

    • Jika percobaan 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 tanda --ignore-errors dan coba lagi perintahnya.

Untuk informasi tentang flag lainnya, lihat referensi gcloud CLI.

Membersihkan resource

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

Membersihkan VM cluster pengguna di vSphere

Untuk memverifikasi bahwa VM cluster pengguna telah 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 resource pool, temukan VM yang diawali dengan nama cluster pengguna Anda. Ini adalah node bidang kontrol untuk cluster pengguna Anda. Akan ada satu atau tiga dari ini, bergantung pada apakah cluster pengguna Anda memiliki panel 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, file tersebut akan diwarisi dari cluster admin.

  5. Di bagian resource pool, temukan VM yang diawali dengan nama node pool 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 Traffic Lokal > Server Virtual > Daftar Server Virtual.
  3. Di menu Virtual Servers, hapus semua IP virtual.
  4. Pilih Pools, lalu hapus semua pool.
  5. Pilih Nodes, lalu hapus semua node.

Setelah Anda selesai

Setelah cluster dihapus, Anda dapat menghapus kubeconfig cluster pengguna.