פתרון בעיות ביצירה או בעדכון של אשכול

בדף הזה מוסבר איך לפתור בעיות שקשורות להתקנה או לשדרוג של GKE ב-Azure.

לקבלת עזרה נוספת, אפשר לפנות אל Cloud Customer Care.

כשלים ביצירת אשכולות

כשמגישים בקשה ליצירת אשכול, GKE on Azure מריץ קודם סדרה של בדיקות לפני ההפעלה כדי לאמת את הבקשה. אם יצירת האשכול נכשלת, יכול להיות שאחת מהבדיקות המקדימות נכשלה או ששלב בתהליך יצירת האשכול עצמו לא הושלם.

אם בדיקה לפני הפעלה נכשלת, לא נוצרים משאבים באשכול ומוחזר לכם מידע על השגיאה ישירות. לדוגמה, אם מנסים ליצור אשכול בשם invalid%%%name, בדיקת ההתאמה מראש לשם אשכול תקין נכשלת והבקשה מחזירה את השגיאה הבאה:

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

יכול להיות שיצירת האשכול תיכשל גם אחרי שהבדיקות המקדימות יעברו בהצלחה. יכול להיות שהבעיה הזו תתרחש כמה דקות אחרי שהתחילה יצירת האשכול, אחרי ש-GKE ב-Azure יצר משאבים ב- Google Cloud וב-Azure. במקרה כזה, משאב Azure יהיה קיים ב Google Cloud פרויקט עם הסטטוס ERROR.

כדי לקבל פרטים על הכשל, מריצים את הפקודה הבאה:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CLUSTER_NAME בשם האשכול שאת המצב שלו רוצים לבדוק
  • ‫GOOGLE_CLOUD_LOCATION עם שם האזור Google Cloud שמנהל את אשכול Azure הזה

לחלופין, אפשר לקבל פרטים על הכשל ביצירה על ידי תיאור המשאב Operation שמשויך לקריאה ל-API של יצירת אשכול.

gcloud container azure operations describe OPERATION_ID

מחליפים את OPERATION_ID במזהה הפעולה שיצרה את האשכול. אם אין לכם את מזהה הפעולה של בקשת יצירת האשכול, אתם יכולים לאחזר אותו באמצעות הפקודה הבאה:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

משתמשים בחותמת הזמן או במידע שקשור לנושא כדי לזהות את פעולת יצירת האשכול שמעניינת אתכם.

עדכוני אשכולות שנכשלו

כשמעדכנים אשכול, בדיוק כמו כשיוצרים אשכול חדש, GKE on Azure מריץ קודם סדרה של בדיקות לפני ההפעלה כדי לאמת את הבקשה. אם עדכון האשכול נכשל, יכול להיות שאחד מהבדיקות המקדימות נכשל או ששלב בתהליך עדכון האשכול לא הושלם.

אם בדיקה לפני הפעלה נכשלת, אף משאב באשכול לא מתעדכן, ופרטי השגיאה מוחזרים ישירות אליכם. לדוגמה, אם מנסים לעדכן אשכול כדי להשתמש בזוג מפתחות SSH עם השם test_ec2_keypair, הבדיקה המקדימה מנסה לאחזר את זוג המפתחות של EC2 ונכשלת, והבקשה מחזירה את השגיאה הבאה:

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

יכול להיות שעדכוני אשכול ייכשלו גם אחרי שהבדיקות המקדימות עברו בהצלחה. יכול להיות שהבעיה הזו תתרחש כמה דקות אחרי שהעדכון של האשכול התחיל, והמצב של משאב Azure בפרויקט Google Cloud מוגדר ל-DEGRADED.

כדי לקבל פרטים על הכשל ועל הפעולה שקשורה אליו, פועלים לפי השלבים שמתוארים במאמר בנושא כשלים ביצירת אשכול.

המאמרים הבאים