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 yang memungkinkan Anda mengelola siklus proses cluster on-premise menggunakan Terraform dan alatGoogle Cloud standar. GKE On-Prem API berjalan di infrastruktur Google Cloud. Terraform, konsol Google Cloud, dan Google Cloud CLI adalah klien API, dan ketiganya menggunakan API untuk membuat, memperbarui, mengupgrade, dan menghapus cluster di pusat data Anda. Jika Anda membuat cluster menggunakan
klien standar, cluster akan terdaftar di GKE On-Prem API, yang
berarti Anda dapat menggunakan klien standar untuk mengelola siklus proses cluster
(dengan beberapa pengecualian).
Jika Anda memerlukan bantuan tambahan, hubungi
Cloud Customer Care.
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/[...]/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:
- Hapus cluster.
- Buat cluster lagi dengan nama lain yang tidak bertentangan dengan cluster yang ada.
Error alamat IP yang bertentangan
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"
Anda tidak dapat mengedit kolom seperti Control plane VIP dan Ingress VIP di bagian Load balancer pada halaman Cluster details di konsol Google Cloud. Untuk memperbaiki alamat IP yang mengalami konflik, hapus dan buat ulang cluster:
- Hapus cluster.
- Buat cluster lagi dengan alamat IP yang tidak bertentangan dengan cluster yang ada.
Menghapus cluster yang tidak responsif
Cluster dapat berada dalam status tidak sehat karena berbagai alasan, seperti:
- Masalah konektivitas dengan Connect Agent atau lingkungan lokal.
- Cluster admin untuk cluster pengguna telah dihapus, atau ada masalah konektivitas antara cluster admin dan pengguna.
Jika konsol tidak dapat menghapus cluster, gunakan perintah gcloud CLI untuk menghapus resource Google Cloud dari cluster 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 akan dihapus.PROJECT_ID
: ID project tempat cluster didaftarkan.REGION
: Lokasi Google Cloud yang terkait dengan cluster pengguna. Lokasi ditampilkan di konsol.Flag
--force
menghapus cluster yang memiliki node pool. Tanpa tanda--force
, Anda harus menghapus kumpulan node terlebih dahulu, lalu menghapus cluster.Flag
--allow-missing
memungkinkan perintah dilanjutkan jika cluster tidak ditemukan.Flag
--ignore-errors
menghapus resource Google Cloud saat cluster admin dan pengguna tidak dapat dijangkau.Perintah ini akan menghapus cluster jika ada dan menghapus resource GKE On-Prem API dan keanggotaan fleet dari Google Cloud.
Pastikan resource GKE On-Prem API telah dihapus:
gcloud container bare-metal clusters list \ --project=PROJECT_ID \ --location=-
Jika Anda menetapkan
--location=-
, artinya Anda mencantumkan semua cluster di semua wilayah. Jika Anda perlu mempersempit cakupan daftar, tetapkan--location
ke region tertentu.Pastikan resource langganan 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 .
Flag
--allow-missing
membatalkan pendaftaran cluster jika keanggotaan fleet tidak ditemukan.Flag
--ignore-errors
menghapus resourceGoogle Cloud saat cluster admin dan pengguna tidak dapat dijangkau.Perintah ini akan 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
Jika Anda menetapkan
--location=-
, artinya Anda mencantumkan semua cluster di semua wilayah. Jika Anda perlu mempersempit cakupan daftar, tetapkan--location
ke region tertentu.Pastikan resource langganan fleet telah dihapus:
gcloud container fleet memberships list \ --project=PROJECT_ID
Langkah berikutnya
Jika Anda memerlukan bantuan tambahan, hubungi Cloud Customer Care.