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:
Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.
Pilih project Google Cloud tempat cluster pengguna berada.
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 tabgkectl
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.Klik nama cluster yang ingin dihapus.
Di panel Details, di dekat bagian atas jendela, klik
Delete.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:
Perbarui komponen:
gcloud components update
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
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:
Dari menu Navigator sebelah kiri vSphere Web Client, klik menu Hosts and Clusters.
Temukan kumpulan resource untuk cluster admin Anda. Ini adalah nilai
vCenter.resourcePool
dalam file konfigurasi cluster admin Anda.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.
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.Di bawah kumpulan resource, temukan VM yang diawali dengan nama kumpulan node di cluster pengguna Anda. Ini adalah node pekerja di cluster pengguna Anda.
Untuk setiap node bidang kontrol dan setiap node pekerja:
Dari vSphere Web Client, klik kanan VM, lalu pilih Power > Power Off.
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:
- Dari konsol F5 BIG-IP, di pojok kanan atas konsol, beralihlah ke partisi cluster pengguna yang ingin Anda bersihkan.
- Pilih Local Traffic > Virtual Servers > Virtual Server List.
- Pada menu Virtual Servers, hapus semua IP virtual.
- Pilih Pools, lalu hapus semua kumpulan.
- Pilih Node, lalu hapus semua node.
Setelah Anda menyelesaikan
Setelah cluster dihapus, Anda dapat menghapus kubeconfig cluster pengguna.