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:
Buka halaman Cluster GKE. Halaman ini menampilkan semua cluster Anda.
Klik
Actions di samping cluster dalam daftar yang ingin Anda batalkan pendaftarannya.Di menu Tindakan, pilih Batalkan pendaftaran.
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:
Di konsol Google Cloud, buka halaman ringkasan cluster Google Kubernetes Engine.
Pilih project Google Cloud tempat cluster berada.
Klik nama cluster yang ingin Anda lepaskan, lalu pilih Lihat detail selengkapnya di panel samping.
Di dekat bagian atas jendela, klik
Hapus.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:
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 kolomEXTERNAL_ID
mencantumkan UID cluster dari namespace kube-system.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.