Memecahkan masalah umum

Halaman ini menunjukkan cara menyelesaikan masalah umum terkait GKE di Azure.

Jika Anda memerlukan bantuan tambahan, hubungi Layanan Pelanggan Cloud.

Pesan error umum

Bagian berikut menjelaskan penyebab dan resolusi 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 node pool yang berjalan, atau Connect gateway tidak dapat terhubung ke node pool. Untuk memeriksa status node pool, jalankan perintah berikut:

gcloud container azure node-pools list \
    --cluster-name CLUSTER_NAME \
    --location LOCATION

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster Anda
  • LOCATION: lokasi yang mengelola cluster Anda Google Cloud

Output menyertakan status node pool cluster Anda. Jika Anda tidak memiliki node pool yang tercantum, Buat node pool.

Pengguna yang dilarang

Error berikut terjadi jika nama pengguna Anda tidak memiliki akses administrator ke cluster Anda:

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 --admin-users flag saat membuat cluster.

Jika Anda menggunakan Connect gateway dan tidak dapat terhubung ke cluster, coba langkah-langkah berikut:

  1. Dapatkan pengguna yang diizinkan untuk cluster Anda.

    gcloud container azure clusters describe CLUSTER_NAME \
    --format 'value(authorization.admin_users)'

    Ganti CLUSTER_NAME dengan nama cluster Anda.

    Output menyertakan nama pengguna dengan akses administrator ke cluster. Contoh:

    {'username': 'administrator@example.com'}

  2. Dapatkan nama pengguna yang saat ini diautentikasi dengan Google Cloud CLI.

    gcloud config get-value account

    Output menyertakan akun yang diautentikasi dengan Google Cloud CLI. Jika output gcloud containers azure clusters describe dan gcloud config get-value account tidak cocok, jalankan gcloud auth login dan lakukan autentikasi sebagai nama pengguna dengan akses administratif ke cluster.

Masalah dengan 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 tunggu habis, alasan paling umum adalah Anda belum membuat node pool. Secara default, GKE di Azure menghasilkan file kubeconfig yang menggunakan Connect gateway sebagai endpoint yang dapat dijangkau internet. Agar hal ini berfungsi, Deployment gke-connect-agent harus berjalan di node pool pada cluster.

Untuk informasi diagnostik selengkapnya, jalankan perintah berikut:

kubectl cluster-info -v=9

Jika tidak ada node pool yang berjalan, Anda akan melihat permintaan ke connectgateway.googleapis.com gagal dengan error cannot find active connections for cluster 404.

Untuk cluster dengan versi Kubernetes 1.25 atau yang lebih baru, gke-connect-agent berjalan di bidang kontrol, dan node pool 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 Connect gateway. Ini adalah batasan saat menggunakan Connect gateway sebagai endpoint Server Kubernetes API 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 generik

Jika Anda menggunakan Connect gateway:

  • Pastikan Anda telah mengaktifkan Connect gateway di project Google Cloud Anda:

    gcloud services enable connectgateway.googleapis.com

  • Untuk cluster dengan versi Kubernetes yang lebih lama dari 1.25, pastikan Anda memiliki setidaknya satu node pool Linux yang berjalan dan gke-connect-agent berjalan. Untuk mengetahui detailnya, lihat Memecahkan masalah koneksi cluster.

  • Untuk cluster dengan versi Kubernetes 1.25 atau yang lebih baru, periksa gke-connect-agent log dengan Cloud Logging.

Langkah berikutnya