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.
Cluster admin tidak ditampilkan di menu drop-down Dasar-dasar cluster
Cluster admin harus terdaftar di
fleet sebelum Anda dapat membuat cluster pengguna di
konsol Google Cloud. Jika Anda tidak melihat cluster admin di
daftar drop-down di bagian Dasar-dasar cluster di Konsol Google Cloud,
cluster admin tidak terdaftar, atau telah didaftarkan menggunakan
Perintah gcloud container fleet memberships register
. Perintah gcloud
ini
tidak mendaftarkan klaster admin
dengan benar.
Periksa status pendaftaran:
Di Konsol Google Cloud, buka Kubernetes Engine > Clusters, dan pilih project Google Cloud yang sama dengan tempat Anda mencoba membuat pengguna .
Jika cluster admin tidak ditampilkan di daftar, lihat Daftarkan cluster admin.
Jika cluster admin ditampilkan di daftar, perilaku ini menunjukkan bahwa cluster telah didaftarkan menggunakan perintah
gcloud container hub memberships register
. Perintahgcloud
ini tidak mendaftarkan admin dengan benar klaster.
Untuk memperbaiki masalah pendaftaran, selesaikan langkah-langkah berikut:
Hapus keanggotaan fleet cluster admin.
gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=global
ADMIN_CLUSTER_NAME
: nama cluster admin.PROJECT_ID
: ID project host perangkat. Ini adalah project yang Anda pilih saat mencoba membuat cluster pengguna di Konsol Google Cloud.
Ikuti langkah-langkah di 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 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:
- Hapus cluster.
- Buat cluster lagi dengan nama lain yang tidak bertentangan dengan cluster yang ada.
Error kelompok anti-afinitas
Pembuatan cluster pengguna gagal dengan pesan error yang mirip dengan berikut:
- 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 dengan minimal 3 {i>host<i} fisik di lingkungan vSphere Anda. Untuk memperbaiki masalah ini, nonaktifkan Kelompok anti-afinitas di bagian Fitur pada Detail cluster untuk cluster Anda, seperti berikut:
Di Konsol Google Cloud, buka halaman cluster GKE.
Pilih project Google Cloud tempat cluster pengguna berada.
Dalam daftar cluster, klik nama cluster, lalu klik Lihat detail di panel Detail.
Di bagian Fitur, klik
Edit.Hapus centang pada opsi Aktifkan grup Anti-afinitas, lalu klik Selesai.
Konsol Google Cloud menampilkan Status cluster: perubahan di progresnya. Klik Show Details untuk melihat Resource status kondisi dan Pesan status.
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 :
- Hapus 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.
- VM cluster telah dihapus sebelum cluster dihapus.
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 vmware 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. Beberapa resource F5 atau vSphere mungkin tertinggal. Lihat Membersihkan resource informasi tentang cara membersihkan sumber daya yang tersisa.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 vmware 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 vmware admin-clusters unenroll ADMIN_CLUSTER_NAME \ --project=PROJECT_ID \ --location=REGION \ --allow-missing
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.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