Memecahkan masalah pembuatan atau update cluster

Halaman ini menunjukkan cara menyelesaikan masalah terkait penginstalan atau upgrade GKE di Azure.

Jika Anda memerlukan bantuan lainnya, hubungi Cloud Customer Care.

Kegagalan pembuatan cluster

Saat Anda membuat permintaan untuk membuat cluster, GKE di Azure akan menjalankan serangkaian pengujian pra-penerbangan terlebih dahulu untuk memverifikasi permintaan tersebut. Jika pembuatan cluster gagal, hal ini dapat disebabkan karena salah satu pengujian pra-peluncuran ini gagal atau karena langkah dalam proses pembuatan cluster itu sendiri tidak selesai.

Jika pengujian pra-peluncuran gagal, cluster Anda tidak akan membuat resource apa pun, dan menampilkan informasi tentang error secara langsung kepada Anda. Misalnya, jika Anda mencoba membuat cluster dengan nama invalid%%%name, pengujian pre-flight untuk nama cluster yang valid akan gagal dan permintaan akan menampilkan error berikut:

ERROR: (gcloud.container.azure.clusters.create) INVALID_ARGUMENT: must be
between 1-63 characters, valid characters are /[a-z][0-9]-/, should start with a
letter, and end with a letter or a number: "invalid%%%name",
field: azure_cluster_id

Pembuatan cluster juga dapat gagal setelah pengujian pra-penerbangan lulus. Proses ini dapat terjadi beberapa menit setelah pembuatan cluster dimulai, setelah GKE di Azure membuat resource di Google Cloud dan Azure. Dalam hal ini, resource Azure akan ada di project Google Cloud Anda dengan status ditetapkan ke ERROR.

Untuk mendapatkan detail tentang kegagalan, jalankan perintah berikut:

gcloud container azure clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --format "value(state, errors)"

Ganti kode berikut:

  • CLUSTER_NAME dengan nama cluster yang statusnya sedang Anda kueri
  • GOOGLE_CLOUD_LOCATION dengan nama region Google Cloud yang mengelola cluster Azure ini

Atau, Anda bisa mendapatkan detail tentang kegagalan pembuatan dengan menjelaskan resource Operation yang terkait dengan panggilan API buat cluster.

gcloud container azure operations describe OPERATION_ID

Ganti OPERATION_ID dengan ID operasi yang membuat cluster. Jika tidak memiliki ID operasi untuk permintaan pembuatan cluster, Anda dapat mengambilnya dengan perintah berikut:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

Gunakan stempel waktu atau informasi terkait untuk mengidentifikasi operasi pembuatan cluster yang diminati.

Kegagalan update cluster

Saat Anda mengupdate cluster, sama seperti saat membuat cluster baru, GKE di Azure terlebih dahulu menjalankan serangkaian uji pra-penerbangan untuk memverifikasi permintaan. Jika update cluster gagal, hal ini dapat disebabkan karena salah satu pengujian pra-peluncuran tersebut gagal, atau karena langkah dalam proses update cluster itu sendiri tidak selesai.

Jika pengujian pra-peluncuran gagal, cluster Anda tidak akan memperbarui resource apa pun, dan menampilkan informasi tentang error secara langsung kepada Anda. Misalnya, jika Anda mencoba memperbarui cluster untuk menggunakan pasangan kunci SSH dengan nama test_ec2_keypair, pengujian sebelum beroperasi akan mencoba mengambil pasangan kunci EC2 dan gagal, serta permintaan menampilkan error berikut:

ERROR: (gcloud.container.azure.clusters.update) INVALID_ARGUMENT: key pair
"test_ec2_keypair" not found,
field: azure_cluster.control_plane.ssh_config.ec2_key_pair

Update cluster juga dapat gagal setelah pengujian pra-penerbangan lulus. Proses ini dapat terjadi beberapa menit setelah update cluster dimulai, dan resource Azure Anda di project Google Cloud menetapkan status ke DEGRADED.

Untuk mendapatkan detail tentang kegagalan dan operasi terkait, ikuti langkah-langkah yang dijelaskan dalam kegagalan pembuatan cluster.

Langkah selanjutnya