Membatalkan pendaftaran cluster

Halaman ini menjelaskan cara membatalkan pendaftaran cluster secara manual dari fleet Google Cloud. Saat Anda membatalkan pendaftaran cluster secara manual, koneksinya ke fleet akan dihapus, tetapi cluster tetap ada. Menghapus cluster GKE terdaftar di Google Cloud menggunakan konsol Google Cloud atau gcloud CLI juga akan menghapus keanggotaan fleet cluster.

Anda hanya dapat membatalkan pendaftaran cluster GKE di Google Cloud dan cluster pihak ketiga yang terpasang. Jenis cluster lainnya tidak dapat dibatalkan pendaftarannya.

Perhatikan bahwa memindahkan cluster terdaftar antar-fleet (membatalkan pendaftaran, lalu mendaftarkan ulang) tidak direkomendasikan, karena dapat menyebabkan perilaku yang tidak terduga atau tidak diinginkan: misalnya, Workload Identity fleet workload Anda akan berubah, yang berpotensi menyebabkan permintaan diblokir dan pemadaman. Pendekatan yang direkomendasikan adalah membuat cluster baru di fleet tempat Anda ingin menempatkan workload, lalu memindahkan workload dari cluster lama ke cluster baru.

Membatalkan pendaftaran cluster

gcloud

Membatalkan pendaftaran cluster GKE

Perintah ini hanya dapat digunakan untuk membatalkan pendaftaran cluster GKE yang terdaftar menggunakan gcloud container clusters update atau gcloud container clusters create.

Jalankan perintah berikut:

gcloud container clusters update CLUSTER_NAME --clear-fleet-project

Ganti CLUSTER_NAME dengan nama cluster yang ingin Anda hapus.

Membatalkan pendaftaran cluster GKE (perintah lama)

Jika Anda mendaftarkan cluster menggunakan perintah register yang lebih lama, jalankan salah satu perintah berikut untuk membatalkan pendaftarannya:

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-uri=[GKE_URI]
gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-cluster=[GKE_CLUSTER]

dengan:

  • [PROJECT_ID] adalah ID project Google Cloud Anda. Pelajari cara menemukan nilai ini.
  • [MEMBERSHIP_NAME] adalah nama keanggotaan yang sesuai dengan cluster Anda. Untuk mencantumkan semua langganan di Hub, jalankan: gcloud container fleet memberships list.
  • [GKE_URI] adalah URI cluster GKE, misalnya: 'https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster'. Anda bisa mendapatkan URI dengan menjalankan gcloud container clusters list --uri. URI yang diberikan akan divalidasi untuk mengonfirmasi bahwa URI tersebut dipetakan ke cluster GKE yang valid.
  • [GKE_CLUSTER] adalah location/name dari cluster GKE. Lokasi dapat berupa zona atau region, misalnya: us-central1-a/my-cluster.

Membatalkan pendaftaran cluster yang terlampir

Petunjuk ini berlaku untuk cluster yang terdaftar menggunakan versi terbaru fitur cluster terlampir kami. Cluster yang dilampirkan menggunakan generasi sebelumnya dari fitur ini yang tidak digunakan lagi harus menggunakan perintah lama di bagian berikutnya.

Membatalkan pendaftaran cluster yang terpasang (perintah lama)

Jika Anda mendaftarkan cluster menggunakan cluster terlampir generasi sebelumnya, jalankan perintah berikut untuk membatalkan pendaftarannya:

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --context=[KUBECONFIG_CONTEXT] \
   --kubeconfig=[KUBECONFIG_PATH]

dengan:

  • [PROJECT_ID] adalah ID project Google Cloud Anda. Pelajari cara menemukan nilai ini.
  • [MEMBERSHIP_NAME] adalah nama keanggotaan yang sesuai dengan cluster Anda. Untuk mendapatkan daftar semua langganan di Hub, jalankan: gcloud container fleet memberships list.
  • [KUBECONFIG_PATH] adalah jalur lokal tempat kubeconfig Anda yang berisi entri untuk file cluster disimpan. Nilai default-nya adalah $KUBECONFIG jika variabel lingkungan tersebut ditetapkan, jika tidak, nilai default-nya adalah $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] adalah konteks cluster seperti yang muncul dalam file kubeconfig. Anda bisa mendapatkan nilai ini dari command line dengan menjalankan kubectl config current-context.

Konsol

Membatalkan pendaftaran cluster GKE di Google Cloud

Untuk membatalkan pendaftaran cluster GKE:

  1. Buka halaman Cluster GKE. Halaman ini menampilkan semua cluster Anda.

    Buka halaman Cluster GKE

  2. Klik Actions di samping cluster dalam daftar yang ingin Anda batalkan pendaftarannya.

  3. Di menu Tindakan, pilih Batalkan pendaftaran.

  4. Pada dialog yang ditampilkan, ketik nama cluster, lalu klik Unregister untuk mengonfirmasi tindakan.

Membatalkan pendaftaran cluster pihak ketiga yang terpasang

Untuk membatalkan pendaftaran cluster yang terpasang:

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

    Buka cluster GKE

  2. Pilih project Google Cloud tempat cluster berada.

  3. Klik nama cluster yang ingin Anda lepaskan, lalu pilih Lihat detail selengkapnya di panel samping.

  4. Di dekat bagian atas jendela, klik Hapus.

  5. Saat diminta untuk mengonfirmasi, masukkan nama cluster, lalu klik Konfirmasi.

Terraform

Untuk membatalkan pendaftaran cluster GKE yang Anda daftarkan menggunakan Terraform:

Hapus blok berikut dari konfigurasi resource google_container_cluster cluster:

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT adalah project ID Google Cloud tempat cluster Anda terdaftar.

Mengelola Connect Agent

Langkah-langkah berikut hanya berlaku untuk membatalkan pendaftaran cluster yang terpasang, tempat Agen Connect diinstal di cluster sebagai bagian dari pendaftaran.

Opsional: Pastikan namespace Agen Connect dihapus

Setelah membatalkan pendaftaran cluster, Anda dapat memverifikasi bahwa namespace yang digunakan oleh Agen Connect telah dihapus. Hal ini hanya berlaku untuk pendaftaran yang menginstal Agen Connect. Untuk melakukannya, jalankan:

kubectl get ns -l hub.gke.io/project

Jika perintah ini tidak menampilkan output, namespace telah dihapus.

Menghapus Akun Layanan Agen Connect

Jika Anda membuat akun layanan untuk Agen Connect, Anda dapat menghapusnya sebagai berikut:

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

Membatalkan pendaftaran cluster yang tidak tersedia

Jika Anda ingin membatalkan pendaftaran cluster yang tidak dapat diakses lagi, lakukan langkah-langkah berikut:

  1. Cantumkan cluster (alias keanggotaan) yang saat ini terdaftar:

    gcloud container fleet memberships list

    Dalam output perintah, kolom Name mencantumkan nama keanggotaan cluster yang terdaftar, dan kolom EXTERNAL_ID mencantumkan UID cluster dari namespace kube-system.

  2. Untuk membatalkan pendaftaran cluster yang tidak tersedia, jalankan perintah berikut:

    gcloud container fleet memberships delete [MEMBERSHIP_NAME]

    dengan [MEMBERSHIP_NAME] adalah nama keanggotaan yang sesuai dengan cluster Anda.