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 yang terdaftar di Google Cloud menggunakan Konsol Google Cloud atau gcloud CLI juga akan menghapus keanggotaan fleet cluster.

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

Perlu diperhatikan bahwa memindahkan cluster terdaftar antar- fleet (membatalkan pendaftaran lalu mendaftar ulang) tidak direkomendasikan karena dapat menyebabkan perilaku yang tidak terduga atau tidak diinginkan. Misalnya, Workload Identity fleet workload Anda akan berubah, yang berpotensi mengakibatkan permintaan diblokir dan pemadaman layanan. Pendekatan yang direkomendasikan adalah membuat cluster baru dalam fleet tempat Anda ingin workload berada, 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 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 dapat memperoleh 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 ditambahkan menggunakan fitur generasi sebelumnya yang tidak digunakan lagi harus menggunakan perintah lama di bagian berikutnya.

Membatalkan pendaftaran cluster yang terpasang (perintah lama)

Jika Anda mendaftarkan cluster menggunakan cluster terpasang 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 penyimpanan kubeconfig Anda yang berisi entri untuk file cluster. Nilai default-nya adalah $KUBECONFIG jika variabel lingkungan tersebut ditetapkan. Jika tidak, nilai default-nya adalah $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] adalah konteks cluster 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 GKE Clusters. Halaman ini menampilkan semua cluster Anda.

    Buka halaman GKE Clusters

  2. Klik Tindakan 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 dan klik Batalkan Pendaftaran untuk mengonfirmasi tindakan.

Membatalkan pendaftaran cluster pihak ketiga terlampir

Untuk membatalkan pendaftaran cluster yang terlampir:

  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 View more details di panel samping.

  4. Di dekat bagian atas jendela, klik Hapus.

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

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 ID project Google Cloud yang terdaftar untuk cluster Anda.

Mengelola Agen Connect

Langkah berikut hanya berlaku untuk membatalkan pendaftaran cluster terlampir, tempat Agen Connect diinstal di cluster sebagai bagian dari pendaftaran.

Opsional: Pastikan namespace Agen Connect telah dihapus

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

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

Jika perintah ini tidak menghasilkan output, berarti namespace telah dihapus.

Menghapus Akun Layanan Connect Agent

Jika 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 ingin membatalkan pendaftaran cluster yang tidak dapat Anda akses 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 terdaftar, dan kolom EXTERNAL_ID mencantumkan UID cluster dari namespace sistem kube.

  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.