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

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

‫GKE On-Prem API הוא API שמתארח ב-Google Cloud ומאפשר לכם לנהל את מחזור החיים של אשכולות מקומיים באמצעות Terraform וGoogle Cloud כלים סטנדרטיים. ‫GKE On-Prem API פועל בתשתית של 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 בקטע Load balancer בדף Cluster details במסוףGoogle Cloud . כדי לתקן כתובות IP מתנגשות, צריך למחוק את האשכול וליצור אותו מחדש:

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

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

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

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

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

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. מסירים את האשכול מה-Fleet:

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

   הפקודה הזו מסירה משאבי חברות ב-Fleet מ- 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. אפשר גם לעיין במאמר קבלת תמיכה כדי לקבל מידע נוסף על מקורות תמיכה, כולל:

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