מבוא לפתרון בעיות

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

שדרוג לגרסה נתמכת

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

שימוש בכלי שורת הפקודה nomos

כלי שורת הפקודה nomos מספק תובנות חשובות לגבי הגדרת סנכרון תצורות. הפקודות שמתוארות בקטעים הבאים שימושיות במיוחד כשמנסים לזהות את מקור הבעיה או כשצריך לעבוד עם Cloud Customer Care.

צפייה בסטטוס של סנכרון תצורות

הפקודה nomos status מספקת לכם נתונים נצברים ושגיאות כדי לעזור לכם להבין מה קורה בהתקנה של סנכרון תצורות. המידע הבא זמין ב-nomos status:

  • סטטוס ההתקנה לכל אשכול
  • שגיאות בסנכרון (גם בקריאה מ-Git וגם בתיאום השינויים)

יצירת דוח על באג

אם נתקלתם בבעיה ב-סנכרון תצורות ואתם צריכים עזרה מ-Cloud Customer Care, אתם יכולים לספק להם מידע חשוב לניפוי באגים באמצעות הפקודה nomos bugreport.

הפקודה הזו יוצרת קובץ ZIP עם חותמת זמן ומידע על אשכול Kubernetes שהוגדר בהקשר kubectl. הקובץ מכיל גם יומנים מ-Pods של סנכרון תצורות. הוא לא מכיל מידע מהמשאבים שסונכרנו באמצעות Config Sync.

הצגת לוח הבקרה של הסקירה הכללית

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

  • כדי לגשת ללוח הבקרה, במסוף Google Cloud עוברים לדף Config בקטע Features:

    מעבר אל Config

שימוש בניתוח יומנים ובמעקב

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

הסבר על המדדים של סנכרון תצורות

בעזרת מדדים של Config Sync, אפשר לקבל תובנות לגבי התקינות של Config Sync.

מעקב אחרי אובייקטים של RootSync ו-RepoSync

כשמתקינים את סנכרון תצורות באמצעות מסוף Google Cloud או Google Cloud CLI, ‏ סנכרון תצורות יוצר באופן אוטומטי אובייקט RootSync בשבילכם. כשמגדירים סנכרון מכמה מאגרי מידע, אפשר ליצור אובייקטים של RepoSync שמכילים פרטי הגדרה לגבי מאגרי המידע של מרחב השמות.

מעקב אחרי האובייקטים האלה יכול לחשוף מידע חשוב על המצב של סנכרון תצורות. למידע נוסף, ראו מעקב אחרי אובייקטים של RootSync ו-RepoSync.

שימוש במדדי רמת שירות (SLI)

כדי לקבל התראות כש-Config Sync לא פועל כמצופה, משתמשים ב-SLI של Config Sync.

יומני שאילתות

אפשר להשתמש ב-Logs Explorer כדי לאחזר, להציג ולנתח נתוני יומן של סנכרון תצורות. היומנים האלה יכולים להכיל נתוני היסטוריה חשובים שלא נאספים על ידי nomos bugreport כשמפעילים מחדש את ה-Pods של האופרטור או של ה-reconciler. דוגמאות לשאילתות שיכולות לעזור לכם לאבחן את הבעיה מופיעות במאמר שאילתות ביומני סנכרון תצורות.

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

‫סנכרון תצורות מורכב מכמה משאבים בהתאמה אישית שאפשר לשלוח להם שאילתות באמצעות פקודות kubectl. הפקודות האלה עוזרות להבין את הסטטוס של כל אחד מהאובייקטים של Config Sync.

חשוב לדעת את הפרטים הבאים על משאבי Kubernetes שמנוהלים על ידי סנכרון תצורות:

  • ‫config-management-system הוא מרחב השמות שבו אנחנו משתמשים כדי להריץ את כל רכיבי המערכת המרכזיים של סנכרון תצורות.
  • ‫configmanagement.gke.io ו-configsync.gke.io הן קבוצות ה-API שבהן אנחנו משתמשים לכל המשאבים המותאמים אישית.

דוגמאות

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

הצגת רשימה של משאבים מותאמים אישית

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

    kubectl api-resources | grep -E "configmanagement.gke.io|configsync.gke.io"

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

    kubectl get RESOURCE -o yaml.

    מחליפים את RESOURCE בשם המשאב שרוצים לשלוח לגביו שאילתה.

    לדוגמה, הפלט של הפקודה הבאה מאפשר לכם לבדוק את הסטטוס של אובייקט RootSync:

    kubectl get rootsync -n config-management-system -o yaml

בדיקת הערת טוקן של אובייקט

יכול להיות שתרצו לדעת מתי אובייקט מנוהל של Kubernetes עודכן לאחרונה על ידי סנכרון תצורות. כל אובייקט מנוהל מתויג בגיבוב של ה-commit ב-Git, כשהוא שונה לאחרונה, ובנתיב להגדרות שהכילו את השינוי.

לדוגמה, כדי לקבל את ההערה של ClusterRoleBinding בשם namespace-readers, מריצים את הפקודה הבאה:

kubectl get clusterrolebinding namespace-readers

הפלט אמור להיראות כך:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  annotations:
    configmanagement.gke.io/source-path: cluster/namespace-reader-clusterrolebinding.yaml
    configmanagement.gke.io/token: bbb6a1e2f3db692b17201da028daff0d38797771
  name: namespace-readers
...

מידע נוסף זמין במאמר בנושא תוויות והערות.

Accelerate diagnosis with Gemini Cloud Assist

לפעמים, הסיבה לבעיה לא ברורה מיד, גם אחרי השימוש בכלים שמוסברים בקטעים הקודמים. חקירת מקרים מורכבים יכולה להיות ממושכת ולדרוש מומחיות רבה. במקרים כאלה, Gemini Cloud Assist יכול לעזור. הוא יכול לזהות אוטומטית דפוסים נסתרים, לחשוף חריגות ולספק סיכומים שיעזרו לכם לזהות במהירות את הסיבה הסבירה.

גישה ל-Gemini Cloud Assist

כדי לגשת אל Gemini Cloud Assist:

  1. נכנסים לדף כלשהו במסוף Google Cloud .

  2. בסרגל הכלים של מסוף Google Cloud , לוחצים על Open or close Gemini Cloud Assist chat.

    החלונית Cloud Assist תיפתח. אפשר ללחוץ על הנחיות לדוגמה אם הן מוצגות, או להזין הנחיה בשדה הזנת הנחיה.

הנחיות לדוגמה

כדי להבין איך Gemini Cloud Assist יכול לעזור לכם, הנה כמה הנחיות לדוגמה:

עיצוב תרחיש הנחיה לדוגמה איך Gemini Cloud Assist יכול לעזור
הגדרה ראשונית מהנדס פלטפורמה מגדיר את סנכרון תצורות בפעם הראשונה כדי לנהל אשכולות GKE ממאגר Git. איך מגדירים את סנכרון תצורות כדי לסנכרן מניפסטים ממאגר GitHub לאשכול GKE? ‫Gemini Cloud Assist מספק מדריך מפורט להגדרת סנכרון תצורות, שכולל רישום של צי, הפעלה של התכונה והסברים על פרטים כמו כתובת ה-URL של המאגר, ההסתעפות, הנתיב ושיטות האימות (לדוגמה, public,‏ token או ssh).
פתרון בעיות בסנכרון מפתח מבצע קומיט למניפסט חדש, אבל המשאב לא מוחל על האשכול, וסטטוס הסנכרון מציג קוד שגיאה. אובייקט RootSync של סנכרון תצורות מציג את הערך RootSync. מה זה אומר ואיך אפשר לתקן את זה?KNV2009: the server could not find the requested resource ‫Gemini Cloud Assist מנתח את קוד השגיאה ומסביר שהוא מציין בדרך כלל ש-סנכרון תצורות לא יכול לאתר משאב צפוי של Kubernetes או לבצע איתו אינטראקציה. לאחר מכן מפורטות סיבות נפוצות, כולל הרשאות RBAC חסרות, חריגה ממגבלות הגודל של אובייקט המשאב, נתיבי ספריות שגויים, התנגשויות במלאי חיצוני ובעיות במשאבים לא מנוהלים, עם שלבים ספציפיים לפתרון בעיות עבור כל סיבה.
ניהול של כמה צוותים ארגון צריך לאפשר לצוותי אפליקציות לנהל את ההגדרות שלהם במרחבי שמות ספציפיים, בלי לתת להם גישה למאגר המרכזי של הפלטפורמה. מה ההבדל בין אובייקט RootSync לאובייקט RepoSync ב-סנכרון תצורות? מתי כדאי להשתמש ב-RepoSync?

‫Gemini Cloud Assist מסביר את ההבדל העיקרי בין אובייקטים מסוג RootSync לאובייקטים מסוג RepoSync: אובייקטים מסוג RootSync הם בהיקף של אשכול, ובדרך כלל משמשים אדמינים להגדרות ברמת האשכול, בעוד שאובייקטים מסוג RepoSync הם בהיקף של מרחב שמות, ומיועדים לצוותי פיתוח אפליקציות לניהול משאבים במרחב שמות ספציפי, כדי לקדם האצלת סמכויות וריבוי דיירים.

בנוסף, Gemini Cloud Assist מפרט תרחישים שבהם כדאי להשתמש באובייקטים מסוג RepoSync, ומדגיש את היתרונות שלהם בשימוש בכמה דיירים ואת האפשרות לצמצם את האזור שמושפע מטעויות בהגדרות.
אימות יזום מפתח רוצה לוודא שהמניפסט החדש שלו תקין לפני שהוא מעביר אותו למאגר, כדי למנוע שיבוש בסנכרון בסביבת הייצור. איך אפשר לבדוק את מניפסטים של Kubernetes לאיתור שגיאות בסנכרון התצורות במחשב המקומי לפני שמעלים אותם למאגר Git? ‫Gemini Cloud Assist מסביר איך לבדוק מניפסטים של Kubernetes לאיתור שגיאות ב-Config Sync באמצעות כלי שורת הפקודה nomos. במאמר מוסבר איך להשתמש בפקודה nomos vet כדי לאמת את התחביר ובפקודה nomos hydrate כדי לראות תצוגה מקדימה של תצורות שעברו עיבוד מ-Kustomize או מ-Helm. בנוסף, Gemini Cloud Assist מציג תהליך עבודה מומלץ לשילוב הבדיקות האלה לפני שמעלים את הקוד ל-Git.

מידע נוסף זמין במקורות המידע הבאים:

שימוש ב-Gemini Cloud Assist Investigations

בנוסף לצ'אט האינטראקטיבי, Gemini Cloud Assist יכול לבצע ניתוח מעמיק ואוטומטי יותר באמצעות Gemini Cloud Assist Investigations. התכונה הזו משולבת ישירות בתהליכי עבודה כמו Logs Explorer, והיא כלי רב עוצמה לניתוח שורש הבעיה.

כשמתחילים חקירה משגיאה או ממשאב ספציפי, Gemini Cloud Assist מנתח יומנים, הגדרות ומדדים. הכלי משתמש בנתונים האלה כדי ליצור תצפיות והיפותזות מדורגות לגבי הגורמים הסבירים לבעיה, ואז מספק המלצות לגבי השלבים הבאים. אפשר גם להעביר את התוצאות האלה ל Google Cloud בקשת תמיכה כדי לספק הקשר חשוב שיעזור לפתור את הבעיה מהר יותר.

מידע נוסף זמין במאמר חקירות ב-Gemini Cloud Assist במאמרי העזרה של Gemini.

קריאת מסמכי תיעוד נוספים לפתרון בעיות

אם הבעיות נמשכות, יכול להיות שמקורות המידע הבאים יעזרו לכם:

  • אם קיבלתם הודעת שגיאה, תוכלו לעיין בדף הפניה לשגיאות כדי לקבל עצות לפתרון השגיאה.

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

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

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

  • אם לא מצאתם פתרון לבעיה שלכם במסמכים, תוכלו לקבל עזרה נוספת במאמר קבלת תמיכה, כולל עצות בנושאים הבאים: