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:
Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.
Pilih project Google Cloud tempat cluster pengguna berada.
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 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 penghapusan.Klik nama cluster yang ingin dihapus.
Di panel Details, di dekat bagian atas jendela, klik
Delete.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:
Perbarui komponen:
gcloud components update
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:
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 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.
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.Di bagian resource pool, temukan VM yang diawali dengan nama node pool 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 Traffic Lokal > Server Virtual > Daftar Server Virtual.
- Di menu Virtual Servers, hapus semua IP virtual.
- Pilih Pools, lalu hapus semua pool.
- Pilih Nodes, lalu hapus semua node.
Setelah Anda selesai
Setelah cluster dihapus, Anda dapat menghapus kubeconfig cluster pengguna.