Memecahkan masalah umum
Halaman ini menunjukkan cara menyelesaikan masalah umum terkait GKE di Azure.
Jika Anda memerlukan bantuan lainnya, hubungi Cloud Customer Care.Pesan error umum
Bagian berikut menjelaskan penyebab dan solusi untuk beberapa pesan error umum.
Server tidak memiliki resource
Error seperti error: the server doesn't have a resource type "services"
dapat terjadi jika cluster tidak memiliki kumpulan node yang berjalan, atau gateway Connect tidak dapat terhubung ke kumpulan node. Untuk memeriksa status kumpulan node Anda, jalankan perintah berikut:
gcloud container azure node-pools list \
--cluster-name CLUSTER_NAME \
--location LOCATION
Ganti kode berikut:
CLUSTER_NAME
: nama cluster AndaLOCATION
: lokasi Google Cloud yang mengelola cluster Anda
Outputnya mencakup status kumpulan node cluster Anda. Jika Anda tidak memiliki kumpulan node yang tercantum, Create a node pool.
Pengguna terlarang
Error berikut terjadi jika nama pengguna tidak memiliki akses administrator ke cluster:
Error from server (Forbidden): users "administrator@example.com" is forbidden:
User "system:serviceaccount:gke-connect:connect-agent-sa" cannot impersonate
resource "users" in API group "" at the cluster scope
Anda dapat mengonfigurasi pengguna tambahan dengan meneruskan flag --admin-users
saat membuat cluster.
Jika Anda menggunakan gateway Connect dan tidak dapat terhubung ke cluster, coba langkah-langkah berikut:
Memperoleh pengguna yang diotorisasi untuk cluster Anda.
gcloud container azure clusters describe CLUSTER_NAME \ --format 'value(authorization.admin_users)'
Ganti
CLUSTER_NAME
dengan nama cluster Anda.Output-nya mencakup nama pengguna dengan akses administrator ke cluster. Contoh:
{'username': 'administrator@example.com'}
Dapatkan nama pengguna yang saat ini diautentikasi dengan Google Cloud CLI.
gcloud config get-value account
Outputnya mencakup akun yang diautentikasi dengan Google Cloud CLI. Jika output
gcloud containers azure clusters describe
dangcloud config get-value account
tidak cocok, jalankangcloud auth login
dan autentikasi sebagai nama pengguna dengan akses admin ke cluster.
Masalah terkait perintah kubectl
Bagian berikut memberikan panduan tentang cara menyelesaikan masalah dengan
perintah kubectl
yang tidak responsif atau gagal.
Perintah kubectl berhenti merespons
Jika cluster Anda menjalankan versi Kubernetes yang lebih lama dari 1.25 dan perintah kubectl
tidak responsif atau waktu habis, alasan paling umum adalah Anda belum membuat kumpulan node. Secara default, GKE di Azure menghasilkan file kubeconfig
yang menggunakan gateway Connect sebagai endpoint yang dapat dijangkau internet.
Agar berhasil, Deployment gke-connect-agent
harus berjalan di
kumpulan node pada cluster.
Untuk mengetahui informasi diagnostik selengkapnya, jalankan perintah berikut:
kubectl cluster-info -v=9
Jika tidak ada kumpulan node yang berjalan, Anda akan melihat permintaan ke
connectgateway.googleapis.com
gagal dengan error 404
cannot find active connections for cluster
.
Untuk cluster dengan versi Kubernetes 1.25 atau yang lebih baru, gke-connect-agent
berjalan di bidang kontrol, dan kumpulan node tidak diperlukan. Jika perintah kubectl
tidak responsif, periksa log komponen bidang kontrol dengan Cloud Logging.
Perintah kubectl exec, Attach, dan port-forward gagal
Perintah kubectl exec
, kubectl attach
, dan kubectl port-forward
mungkin gagal dengan pesan error: unable to upgrade connection
saat menggunakan gateway Connect. Ini adalah batasan saat menggunakan gateway Connect sebagai endpoint Kubernetes API Server Anda.
Untuk mengatasi hal ini, gunakan kubeconfig
yang menentukan endpoint pribadi cluster. Untuk mengetahui petunjuk cara mengakses cluster melalui endpoint pribadinya, lihat Mengonfigurasi akses cluster untuk kubectl.
Pemecahan masalah kubectl umum
Jika Anda menggunakan gateway Connect:
Pastikan Anda telah mengaktifkan gateway Connect di project Google Cloud:
gcloud services enable connectgateway.googleapis.com
Untuk cluster dengan versi Kubernetes sebelum 1.25, pastikan Anda memiliki setidaknya satu kumpulan node Linux yang berjalan dan
gke-connect-agent
juga berjalan. Untuk mengetahui detailnya, lihat Memecahkan masalah koneksi cluster.Untuk cluster dengan Kubernetes versi 1.25 atau yang lebih baru, periksa log
gke-connect-agent
dengan Cloud Logging.
Langkah selanjutnya
- Jika Anda memerlukan bantuan lainnya, hubungi Cloud Customer Care.