Cluster Anthos on bare metal kini menjadi Google Distributed Cloud (khusus software) untuk bare metal. Untuk mengetahui informasi selengkapnya, lihat ringkasan produk.

Halaman ini diterjemahkan oleh Cloud Translation API.

Memecahkan masalah cluster yang didaftarkan di GKE On-Prem API

Halaman ini menunjukkan cara menyelidiki masalah saat membuat Cluster pengguna Google Distributed Cloud di Konsol Google Cloud.

GKE On-Prem API adalah API yang dihosting Google Cloud dan dapat Anda gunakan untuk siklus proses cluster lokal Anda menggunakan Terraform dan standar alat Google Cloud. GKE On-Prem API berjalan di infrastruktur IT. Terraform, Konsol Google Cloud, dan Google Cloud CLI tentang API, dan menggunakan API ini untuk membuat, memperbarui, menghapus cluster di pusat data Anda. Jika Anda membuat cluster menggunakan klien standar, cluster tersebut terdaftar di GKE On-Prem API, berarti Anda dapat menggunakan klien standar untuk mengelola siklus proses cluster (dengan beberapa pengecualian).

Jika Anda memerlukan bantuan tambahan, hubungi Layanan Pelanggan Cloud.

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 berikut:

Resource 'projects/1234567890/[...]/user-cluster1'
already exists
Request ID: 129290123128705826

Pesan error ini menunjukkan bahwa nama cluster sudah digunakan.

Salah satu solusi untuk memperbaiki masalah ini adalah dengan menghapus dan membuat ulang cluster:

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

Error alamat IP bentrok

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

- 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"

Anda tidak dapat mengedit kolom seperti VIP bidang kontrol dan VIP Ingress di bagian Load balancer pada halaman Cluster details di Konsol Google Cloud. Untuk memperbaiki alamat IP yang bertentangan, hapus dan buat ulang :

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

Hapus cluster yang tidak responsif

Cluster dapat berada dalam kondisi tidak responsif karena berbagai alasan, seperti:

Masalah konektivitas dengan Connect Agent atau lingkungan lokal.
Cluster admin untuk cluster pengguna telah dihapus, atau ada konektivitas antara admin dan cluster pengguna.

Jika konsol tidak dapat menghapus cluster, gunakan Perintah gcloud CLI untuk menghapus resource Google Cloud dari klaster yang tidak sehat. Jika Anda belum mengupdate gcloud CLI baru-baru ini, jalankan perintah berikut untuk mengupdate komponen:

gcloud components update

Selanjutnya, hapus resource Google Cloud.

Cluster pengguna

Hapus cluster pengguna:
```
gcloud container bare-metal clusters delete USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --force \
  --allow-missing \
  --ignore-errors
```
Ganti kode berikut:
- USER_CLUSTER_NAME: Nama cluster pengguna yang ingin dihapus.
- PROJECT_ID: ID project yang cluster terdaftar.
- REGION: Lokasi Google Cloud yang terkait dengan cluster pengguna. Lokasi ditampilkan di konsol.
  
  Flag --force akan menghapus cluster yang memiliki kumpulan node. Tanpa flag --force, Anda harus menghapus kumpulan node terlebih dahulu, lalu hapus cluster tersebut.
  
  Flag --allow-missing memungkinkan perintah dilanjutkan jika cluster tidak ditemukan.
  
  Flag --ignore-errors menghapus resource Google Cloud saat admin dan cluster pengguna tidak dapat dijangkau.
  
  Perintah ini akan menghapus cluster yang ada dan menghapus keduanya GKE On-Prem API dan resource keanggotaan fleet dari Google Cloud.
Pastikan resource GKE On-Prem API telah dihapus:
```
gcloud container bare-metal clusters list \
  --project=PROJECT_ID \
  --location=-
```
Saat Anda menetapkan --location=-, itu berarti membuat daftar semua cluster dalam semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke wilayah tertentu.

Pastikan resource keanggotaan fleet telah dihapus:

gcloud container fleet memberships list \
  --project=PROJECT_ID

Cluster Admin

Jika Anda mendaftarkan cluster admin di GKE On-Prem API, batalkan pendaftarannya:
```
gcloud container bare-metal admin-clusters unenroll ADMIN_CLUSTER_NAME \
 --project=PROJECT_ID \
 --location=REGION \
 --allow-missing --ignore-errors 
```
Ganti kode berikut:
- ADMIN_CLUSTER_NAME: Nama cluster admin.
- PROJECT_ID: ID project host fleet.
- REGION: Region Google Cloud.
Tanda --allow-missing membatalkan pendaftaran cluster jika keanggotaan fleet tidak ditemukan.

Flag --ignore-errors akan menghapus Resource Google Cloud saat admin dan cluster pengguna tidak dapat dijangkau.

Perintah ini menghapus resource GKE On-Prem API dari Google Cloud.

Hapus cluster dari fleet:

gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
 --project=PROJECT_ID \
 --location=global

Perintah ini menghapus resource keanggotaan fleet dari Google Cloud.

Pastikan resource GKE On-Prem API telah dihapus:
```
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID
```
Saat Anda menetapkan --location=-, itu berarti membuat daftar semua cluster dalam semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke wilayah tertentu.

Pastikan resource keanggotaan fleet telah dihapus:

gcloud container fleet memberships list \
  --project=PROJECT_ID

Langkah selanjutnya

Jika Anda memerlukan bantuan tambahan, hubungi Cloud Customer Care.