Menghapus cluster pengguna

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

Memilih alat untuk menghapus cluster

Jika Anda membuat cluster dengan enableAdvancedCluster ditetapkan ke true (yang diperlukan untuk menyiapkan domain topologi), Anda harus menggunakan gkectl untuk menghapus cluster.

Jika tidak, cara menghapus cluster pengguna bergantung pada apakah cluster tersebut terdaftar di GKE On-Prem API. Cluster pengguna didaftarkan di GKE On-Prem API jika salah satu kondisi berikut terpenuhi:

  • Cluster dibuat menggunakan konsol Google Cloud , Google Cloud CLI (gcloud CLI), atau Terraform, yang secara otomatis mendaftarkan cluster di GKE On-Prem API. Secara keseluruhan, alat ini disebut sebagai klien GKE On-Prem API.

  • Cluster dibuat menggunakan gkectl, tetapi didaftarkan 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.33.100-gke.89    example-admin-cluster-1   RUNNING

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

Jika cluster tercantum, cluster tersebut terdaftar 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 yang terdaftar. Untuk mengetahui detail izin yang disertakan dalam peran ini, lihat Peran API GKE On-Prem dalam dokumentasi IAM.

Jika Anda menggunakan gkectl untuk menghapus cluster, pastikan workstation admin Anda memiliki versi gkectl yang diperlukan. Biasanya, Anda menggunakan versi gkectl yang sama dengan versi cluster yang Anda hapus. Aturan versi berikut diterapkan selama penghapusan:

  • Versi minor gkectl tidak boleh lebih rendah dari versi minor cluster. Misalnya, menghapus cluster 1.30 menggunakan gkectl versi 1.29 tidak diizinkan. Versi patch tidak penting. Misalnya, Anda dapat menggunakan gkectl versi 1.29.0-gke.1456 untuk menghapus cluster dengan versi patch yang lebih tinggi, seperti 1.29.1000-gke.94.

  • Versi minor gkectl tidak boleh lebih dari dua versi minor lebih tinggi dari versi cluster. Misalnya, jika Anda menghapus cluster 1.28, versi gkectl dapat berupa 1.29 atau 1.30. Namun, Anda tidak dapat menggunakan gkectl versi 1.31 karena versi tersebut tiga versi minor lebih tinggi daripada versi cluster.

Jika perlu, lihat Mendownload gkectl untuk mendapatkan gkectl versi yang didukung.

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 mencapai gkeonprem.googleapis.com dan gkeonprem.mtls.googleapis.com (nama layanan untuk GKE On-Prem API), maka gkectl akan dapat menghapus cluster yang 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 telah didaftarkan, tetapi gkectl tidak dapat menjangkau GKE On-Prem API. Dalam hal ini, cara termudah 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. Dalam daftar cluster, cari cluster yang ingin Anda hapus. 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 tanda --ignore-errors ke perintah penghapusan.

  4. Klik nama cluster yang ingin Anda hapus.

  5. Di panel Detail, di dekat bagian atas jendela, klik Hapus.

  6. Saat diminta untuk mengonfirmasi, masukkan nama cluster, lalu 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. 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 terdaftar.

    • LOCATION: Google Cloud Lokasi 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, Connect Agent, atau lingkungan lokal.

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

    • Jika mencoba lagi perintah tetap gagal, lihat Mengumpulkan log Connect Agent untuk memecahkan masalah Connect Agent.

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

Untuk mengetahui 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 di 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, cari 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 dengan 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 kumpulan resource, 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 worker node:

    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 masih 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. Di menu Virtual Servers, hapus semua IP virtual.
  4. Pilih Pool, lalu hapus semua pool.
  5. Pilih Nodes, lalu hapus semua node.

Setelah Anda selesai

Setelah cluster dihapus, Anda dapat menghapus kubeconfig cluster pengguna.