Memecahkan masalah saat membuat cluster pengguna di Konsol Google Cloud

Halaman ini menunjukkan cara menyelidiki masalah saat membuat GKE di cluster pengguna VMware di Konsol Google Cloud.

Cluster admin tidak ditampilkan di menu drop-down Dasar-dasar cluster

Cluster admin harus terdaftar ke fleet sebelum Anda dapat membuat cluster pengguna di Konsol Google Cloud. Jika Anda tidak melihat cluster admin pada menu drop-down di bagian Dasar-dasar cluster di Konsol Google Cloud, berarti cluster admin tersebut tidak terdaftar atau terdaftar menggunakan perintah gcloud container hub memberships register.

Periksa status pendaftaran:

Di konsol Google Cloud, buka halaman Anthos > Clusters, lalu pilih project Google Cloud yang sama tempat Anda mencoba membuat cluster pengguna.

Buka halaman cluster GKE Enterprise
- Jika cluster admin tidak ditampilkan dalam daftar, baca bagian Mendaftarkan cluster admin.
- Jika cluster admin ditampilkan dalam daftar, ini menunjukkan bahwa cluster tersebut terdaftar menggunakan perintah gcloud container hub memberships register. Perintah gcloud ini tidak mendaftarkan cluster admin dengan benar.

Untuk memperbaiki masalah pendaftaran:

Di workstation admin, dapatkan nama keanggotaan:

kubectl describe membership membership \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Batalkan pendaftaran cluster admin. Dalam perintah berikut, ganti:
- MEMBERSHIP_NAME dengan nama keanggotaan dari perintah sebelumnya.
- FLEET_HOST_PROJECT_ID dengan ID project host armada Anda. Ini adalah project yang Anda pilih saat mencoba membuat cluster pengguna di Konsol Google Cloud.
- ADMIN_CLUSTER_KUBECONFIG dengan jalur ke file kubeconfig untuk cluster admin Anda.
- ADMIN_CLUSTER_CONTEXT dengan konteks cluster admin seperti yang muncul di file kubeconfig. Anda bisa mendapatkan nilai ini dari command line dengan menjalankan kubectl config current-context.
```
gcloud container fleet memberships unregister MEMBERSHIP_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --kubeconfig=ADMIN_CLUSTER_KUBECONFIG \
  --context=ADMIN_CLUSTER_CONTEXT
```
Ikuti langkah-langkah dalam artikel Mendaftarkan cluster admin untuk mendaftarkan ulang cluster.

Error pembuatan cluster

Bagian ini menjelaskan beberapa error yang terjadi selama pembuatan cluster di Konsol Google Cloud.

Error resource sudah ada

Pembuatan cluster pengguna gagal dengan pesan error yang mirip dengan yang berikut ini:

Resource 'projects/1234567890/locations/europe-west1/vmwareClusters/user-cluster1'
already exists
Request ID: 129290123128705826

Pesan error ini menunjukkan bahwa nama cluster sudah digunakan.

Satu solusi untuk mengatasi masalah ini:

Hapus cluster.
Buat lagi cluster dengan nama lain yang tidak bertentangan dengan cluster yang ada.

Error grup anti-afinitas

Pembuatan cluster pengguna gagal dengan pesan error yang mirip dengan yang berikut ini:

- Validation Category: VCenter
    - [FATAL] Hosts for AntiAffinityGroups: Anti-affinity groups enabled with
    available vsphere host number 1 less than 3, please add more vsphere hosts
    or disable anti-affinity groups.

Aturan anti-afinitas VMware Distributed Resource Scheduler (DRS) memerlukan setidaknya 3 host fisik di lingkungan vSphere Anda. Untuk memperbaiki masalah ini, nonaktifkan Grup anti-afinitas di bagian Features di halaman Cluster details untuk cluster Anda, sebagai berikut:

Di konsol Google Cloud, buka halaman cluster GKE Enterprise.

Buka halaman cluster GKE Enterprise
Pilih project Google Cloud tempat cluster pengguna berada.
Dalam daftar cluster, klik nama cluster, lalu klik View details pada panel Details.
Di bagian Fitur, klik Edit.
Hapus Aktifkan Grup anti-afinitas, lalu klik Selesai.
Konsol Google Cloud akan menampilkan Cluster status: changes in progress. Klik Show Details untuk melihat Resource status condition dan Status messages.

Error alamat IP bentrok

Pembuatan cluster pengguna gagal dengan pesan error yang mirip dengan yang berikut ini:

- Validation Category: Network Configuration
- [FAILURE] CIDR, VIP and static IP (availability and overlapping): user: user
  cluster control plane VIP "10.251.133.132" overlaps with
  example-cluster1/control plane VIP "10.251.133.132"

Saat ini, Anda tidak dapat mengedit kolom seperti Control bidang VIP dan Ingress VIP di bagian Load balancer pada halaman Cluster details di Google Cloud Console. Untuk memperbaiki alamat IP yang bentrok:

Hapus cluster.
Buat cluster lagi dengan alamat IP yang tidak bertentangan dengan cluster yang ada.

Penghapusan cluster gagal menghapus cluster dari Cloud Console

Setelah menghapus cluster pengguna, cluster pengguna masih akan ditampilkan di Konsol Google Cloud. Hal ini dapat terjadi jika cluster pengguna kehilangan konektivitas ke cluster adminnya. Untuk memperbaiki masalah ini, ikuti langkah-langkah di Menghapus resource Anthos On-Prem API.

Menghapus resource GKE On-Prem API

Konsol Google Cloud menggunakan GKE On-Prem API untuk mengelola siklus proses cluster pengguna. Anda juga dapat mengonfigurasi cluster pengguna agar dapat dikelola oleh GKE On-Prem API. Resource GKE On-Prem API tidak dihapus dalam kasus berikut:

gkectl digunakan untuk menghapus kumpulan node untuk cluster pengguna yang dikelola oleh GKE On-Prem API.
Cluster admin untuk cluster pengguna yang dibuat di Cloud Console akan dihapus.

Jika resource GKE On-Prem API tidak dihapus, cluster pengguna masih ditampilkan di Konsol Google Cloud dalam keadaan tidak responsif. Lakukan langkah-langkah berikut untuk menghapus resource yang tersisa.

Tetapkan variabel lingkungan berikut:
```
export PROJECT_ID=FLEET_HOST_PROJECT_ID
export REGION=REGION
export CLUSTER_NAME=USER_CLUSTER_NAME
```
Ganti kode berikut:
- FLEET_HOST_PROJECT_ID: project ID tempat cluster pengguna dibuat, yang juga merupakan project host fleet.
- REGION: region cluster. Region ini ditampilkan di konsol dalam panel Details cluster di kolom Location.
- USER_CLUSTER_NAME: Nama cluster.
Jika kumpulan node cluster pengguna telah dihapus, cluster masih akan terdaftar dengan fleet. Hapus keanggotaan fleet cluster pengguna dengan menjalankan perintah berikut:
```
gcloud container fleet memberships delete USER_CLUSTER_NAME
```
Jika cluster admin telah dihapus, berarti cluster tersebut masih terdaftar dengan fleet. Hapus keanggotaan fleet cluster admin dengan menjalankan perintah berikut:
```
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME
```
Lihat gcloud command reference untuk mengetahui detailnya.

Hapus metadata GKE On-Prem API:

curl -X DELETE "https://gkeonprem.googleapis.com/v1/projects/${PROJECT_ID}/locations/${REGION}/vmwareClusters/${CLUSTER_NAME}:unenroll?force=true&allow_missing=true" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"