פתרון בעיות באשכולות שרשומים ב-GKE On-Prem API

בדף הזה מוסבר איך לחקור בעיות שקשורות ליצירת אשכול משתמשים ב-Google Distributed Cloud במסוף Google Cloud .

‫GKE On-Prem API הוא API שמתארח ב-Google Cloud ומאפשר לכם לנהל את מחזור החיים של האשכולות המקומיים באמצעות Terraform וGoogle Cloud כלים סטנדרטיים. ממשק ה-API של GKE On-Prem פועל בתשתית של Google Cloud. ‫Terraform,‏ Google Cloud console ו-Google Cloud CLI הם לקוחות של ה-API, והם משתמשים ב-API כדי ליצור, לעדכן, לשדרג ולמחוק אשכולות במרכז הנתונים שלכם. אם יצרתם את האשכול באמצעות לקוח רגיל, האשכול נרשם ל-GKE On-Prem API, מה שאומר שאתם יכולים להשתמש בלקוחות הרגילים כדי לנהל את מחזור החיים של האשכול (עם כמה חריגים).

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

בקטע הזה מתוארות כמה שגיאות שקורות במהלך יצירת אשכול במסוףGoogle Cloud .

שגיאה: המשאב כבר קיים

יצירת אשכול משתמשים נכשלת עם הודעת שגיאה שדומה להודעה הבאה:

Resource 'projects/1234567890/[...]/user-cluster1'
already exists
Request ID: 129290123128705826

הודעת השגיאה הזו מציינת ששם האשכול כבר נמצא בשימוש.

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

1. מחיקת האשכול.
2. צריך ליצור את האשכול מחדש עם שם אחר שלא מתנגש עם אשכול קיים.

שגיאה של כתובות IP מתנגשות

יצירת אשכול משתמשים נכשלת עם הודעת שגיאה שדומה להודעה הבאה:

- 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"

אי אפשר לערוך שדות כמו Control plane VIP ו-Ingress VIP בקטע מאזן עומסים (LB) בדף Cluster details במסוףGoogle Cloud . כדי לתקן כתובות IP מתנגשות, צריך למחוק את האשכול וליצור אותו מחדש:

1. מחיקת האשכול.
2. יוצרים את האשכול מחדש עם כתובות IP שלא מתנגשות עם אשכול קיים.

הסרה של אשכולות לא תקינים

יש הרבה סיבות לכך שקלאסטר יכול להיות במצב לא תקין, למשל:

• בעיות בקישוריות ל-Connect Agent או לסביבה המקומית.
• אשכול האדמין של אשכול המשתמשים נמחק, או שיש בעיות בקישוריות בין אשכול האדמין לאשכול המשתמשים.

אם אי אפשר למחוק אשכול במסוף, משתמשים בפקודות ה-CLI של gcloud כדי למחוק Google Cloud משאבים מאשכולות לא תקינים. אם לא עדכנתם לאחרונה את ה-CLI של gcloud, מריצים את הפקודה הבאה כדי לעדכן את הרכיבים:

gcloud components update

לאחר מכן מוחקים את המשאבים. Google Cloud

אשכול משתמשים

1. מוחקים את אשכול המשתמשים:

   gcloud container bare-metal clusters delete USER_CLUSTER_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --force \
     --allow-missing \
     --ignore-errors

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

   • ‫USER_CLUSTER_NAME: השם של אשכול המשתמשים שרוצים למחוק.

   • ‫PROJECT_ID: המזהה של הפרויקט שהאשכול רשום בו.

   • ‫REGION: Google Cloud המיקום שמשויך לאשכול המשתמשים. המיקום מוצג במסוף.

     הדגל --force מוחק אשכול שיש לו מאגרי צמתים. בלי התג --force, צריך קודם למחוק את מאגרי הצמתים ואז למחוק את האשכול.

     הדגל --allow-missing מאפשר להמשיך את הפקודה אם לא נמצא אשכול.

     הדגל --ignore-errors מסיר Google Cloud משאבים כשאי אפשר להגיע לאשכולות של האדמין והמשתמש.

     הפקודה הזו מוחקת את האשכול אם הוא קיים, ומסירה את משאבי GKE On-Prem API ואת משאבי החברות בצי מ- Google Cloud.

2. מוודאים שמשאבי GKE On-Prem API נמחקו:

   gcloud container bare-metal clusters list \
     --project=PROJECT_ID \
     --location=-

   כשמגדירים את --location=-, המשמעות היא שרוצים להציג את כל האשכולות בכל האזורים. אם רוצים לצמצם את הרשימה, מגדירים את --location לאזור ספציפי.

3. מוודאים שמשאבי החברות בצי נמחקו:

   gcloud container fleet memberships list \
     --project=PROJECT_ID

אשכול אדמין

1. אם רשמתם את אשכול האדמין ל-GKE On-Prem API, בטלו את הרישום שלו:

   gcloud container bare-metal admin-clusters unenroll ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --allow-missing --ignore-errors 
   

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

   • ‫ADMIN_CLUSTER_NAME: השם של אשכול האדמין.
   • ‫PROJECT_ID: המזהה של פרויקט המארח של ה-Fleet.
   • ‫REGION: האזור. Google Cloud

   הדגל --allow-missing מבטל את ההרשמה של האשכול אם לא נמצאת חברות ב-Fleet.

   הדגל --ignore-errors מסיר משאביםGoogle Cloud כשהאדמין ואשכולות המשתמשים לא נגישים.

   הפקודה הזו מסירה את משאבי GKE On-Prem API מ- Google Cloud.

2. מסירים את האשכול מהצי:

   gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --location=global

   הפקודה הזו מסירה משאבים של חברות בצי מ- Google Cloud.

3. מוודאים שמשאבי GKE On-Prem API נמחקו:

   gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID
   

   כשמגדירים את --location=-, המשמעות היא שרוצים להציג את כל האשכולות בכל האזורים. אם רוצים לצמצם את הרשימה, מגדירים את --location לאזור ספציפי.

4. מוודאים שמשאבי החברות בצי נמחקו:

   gcloud container fleet memberships list \
     --project=PROJECT_ID

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

לקבלת עזרה נוספת, אפשר לפנות אל Cloud Customer Care. אפשר גם לעיין במאמר קבלת תמיכה לקבלת מידע נוסף על מקורות מידע לתמיכה, כולל:

• דרישות לפתיחת בקשת תמיכה.
• כלים שיעזרו לכם לפתור בעיות, כמו הגדרת הסביבה, היומנים והמדדים.
• רכיבים נתמכים.