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

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

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

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

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

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

צפייה בסטטוס של Config Sync

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

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

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

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

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

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

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

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

  מעבר אל Config

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

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

הסבר על המדדים של Config Sync

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

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

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

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

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

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

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

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

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

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

חשוב לדעת את הפרטים הבאים על משאבי Kubernetes שמנוהלים על ידי Config Sync:

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

דוגמאות

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

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

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

  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 עודכן לאחרונה על ידי Config Sync. כל אובייקט מנוהל מתויג בגיבוב של ה-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
...

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

אבחון מהיר יותר באמצעות Gemini Cloud Assist

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

גישה ל-Gemini Cloud Assist

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

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

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

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

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

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

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

• איך כותבים הנחיות טובות יותר
• איך משתמשים בחלונית של Gemini Cloud Assist
• כדאי לקרוא את הסקירה הכללית על Gemini for Cloud de Confiance ‎.
• איך Gemini for Cloud de Confiance by S3NS ‎ משתמש בנתונים שלכם

שימוש ב-Gemini Cloud Assist Investigations

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

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

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

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

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

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

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

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

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

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

• קבלת תמיכה מהקהילה על ידי פרסום שאלות ב-Stack Overflow. אם אתם משתמשים ב-kpt או ב-Kustomize, תוכלו להשתמש בתג kpt או kustomize כדי לחפש בעיות דומות.
• פתיחת בקשות בקשר לבעיות או בקשות להוספת תכונות באמצעות הכלי הציבורי למעקב אחר בעיות ב-GitHub.