Membatalkan pendaftaran cluster

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

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

Perlu diperhatikan bahwa pemindahan cluster terdaftar antar- fleet (membatalkan pendaftaran lalu mendaftar ulang) tidak direkomendasikan, karena dapat mengakibatkan perilaku yang tidak terduga atau tidak diinginkan: misalnya, Workload Identity fleet workload Anda akan berubah, yang berpotensi menyebabkan pemblokiran permintaan dan pemadaman layanan. Pendekatan yang direkomendasikan adalah membuat cluster baru di fleet tempat Anda ingin workload Anda 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 keanggotaan 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 disediakan akan divalidasi untuk mengonfirmasi bahwa URI tersebut dipetakan ke cluster GKE yang valid.
  • [GKE_CLUSTER] adalah location/name cluster GKE. Lokasi dapat berupa zona atau region, misalnya: us-central1-a/my-cluster.

Membatalkan pendaftaran cluster yang terpasang

Petunjuk ini berlaku untuk cluster yang terdaftar menggunakan versi terbaru fitur cluster yang terpasang. Cluster yang dilampirkan menggunakan fitur ini 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 keanggotaan di Hub, jalankan: gcloud container fleet memberships list.
  • [KUBECONFIG_PATH] adalah jalur lokal tempat kubeconfig Anda yang berisi entri untuk file cluster disimpan. Nilai defaultnya adalah $KUBECONFIG jika variabel lingkungan tersebut disetel. Jika tidak, setelan defaultnya adalah $HOME/.kube/config.
  • [KUBECONFIG_CONTEXT] adalah konteks cluster saat 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

Anda dapat membatalkan pendaftaran cluster GKE di Google Cloud dari Konsol Google Cloud hanya menggunakan halaman Anthos yang lama. Membatalkan pendaftaran dari halaman cluster GKE tidak didukung.

Untuk membatalkan pendaftaran cluster GKE:

  1. Buka halaman Anthos Clusters. Halaman ini menampilkan semua cluster terdaftar Anda.

    Buka halaman Cluster Anthos

  2. Pilih cluster yang ingin Anda batalkan pendaftarannya dari daftar. Panel detail akan ditampilkan.

  3. Di panel detail, klik Batalkan pendaftaran.

  4. Pada dialog yang muncul, klik Batalkan pendaftaran lagi untuk mengonfirmasi tindakan.

Membatalkan pendaftaran cluster pihak ketiga yang terhubung

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 dilepaskan, 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 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 ID project Google Cloud tempat cluster Anda terdaftar.

Mengelola Connect Agent

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

Opsional: Memastikan namespace Connect Agent dihapus

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

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

Jika perintah ini tidak menampilkan output, namespace telah dihapus.

Menghapus Akun Layanan Connect Agent

Jika membuat akun layanan untuk Connect Agent, Anda dapat menghapusnya seperti 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.